project-structure

A set of conventions for organizing a software repository, its documentation, tests, agent instructions, hooks, and change records.

In plain words
What is it for?
Use it when creating or restructuring a repository, writing AGENTS.md or documentation, arranging folders, and defining testing and governance conventions.
Why use it?
It provides a consistent place for source code, tests, tools, generated files, and project rules, making the repository easier to maintain.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/frostney/gocciascript/project-structure
Any agent
npx skills add frostney/GocciaScript --skill project-structure
Clone the repo
git clone --depth 1 https://github.com/frostney/GocciaScript

Made for: Claude Code, Codex.

Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 732 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00052 $0.00732
Opus 5 $0.00026 $0.00366
Sonnet 5 $0.00010 $0.00146
Haiku 4.5 $0.00005 $0.00073

Measured 3d ago against content hash fc734d88dd9d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

project-structure scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

.agents/skills/project-structure/SKILL.md · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project structure

Apply only the roles and documents needed by the requested work. Preserve valid project conventions; surface a material restructuring choice before making it. Language and stack skills own language-specific commands and config.

Core layout

Name these roles according to the ecosystem:

  • Root: user-facing README.md, manifest, one canonical lockfile, agent context, optional contribution rules, and governance files.
  • Source: one conventional source root, organized by domain or namespace.
  • Tests: unit tests co-located with source; end-to-end suites in one top-level project-owned location; add layer-specific tests only for delivered or regression-prone layers.
  • docs/: architecture, quick start, tooling, code style, and deployment.
  • Scripts: one-off automation in scripts/, bin/, or tools/.
  • Generated output: one ignored build/output location.
  • Optional: generator templates, static assets, and provisioned agent skills.

Tests must catch meaningful regressions. End-to-end coverage is the primary system-level net; unit tests cover public module behavior without duplicating the same assertion.

Governance

Projects on this style keep these canonical root files:

  • VISION.md: durable product and technical direction, including exclusions.
  • DEFINITION_OF_READY.md: hard gate before implementation.
  • DEFINITION_OF_DONE.md: hard gate before a change is called shippable.

In a multi-area repo, the nearest area-specific file wins. Link between governance, agent, contributor, and project docs instead of duplicating policy. Flag a missing governance file when a workflow requires it; do not invent a substitute.

Agent context

AGENTS.md is canonical. CLAUDE.md is a symlink to it, or contains only an include plus genuine Claude-specific additions when symlinks are unavailable. Never maintain divergent copies.

Keep the root AGENTS.md lightweight: briefly identify the repository, then spend its context on non-obvious gotchas, exact commands, hard constraints, and safety boundaries. Do not restate a file tree or conventions evident from the repository.

Read the full file on GitHub · 82 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 82 lines · 52 tokens per session scan A fc734d88dd9d

Subscribe to this mod's changes

project-structure is a skill published in the GitHub repository frostney/GocciaScript (20 stars, last pushed 6d ago), licensed MIT. It adds 52 tokens to every session and 732 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

qcad

Use when editing DXF files with a professional open-source 2D CAD application — CAM output, part libraries, isometric projection. QCAD: open-source 2D CAD with DXF as native format, scriptable via ECMAScript.

znlgis/opengis-skills · 53 tokens

oxc-docs

Comprehensive reference for the JavaScript Oxidation Compiler (Oxc) — a collection of high-performance JavaScript tools written in Rust. Covers parser design (lexer, AST, parser, errors, semantic analysis), architecture (parser, linter, test infrastructure, AST tools), ECMAScript specification and grammar, performance…

pledgeandgrow/pledge-skills · 131 tokens

git-step-commit

Analyze Git changes, split them into coherent commits, infer message language and format, optionally close supplied GitHub issues, and execute safely. Manage persistent global or repository preferences for review versus direct submission and automatic or specified commit-message language through native Git config.…

bosens-China/tc39-atlas · 134 tokens

manage-prd-docs

Automatically manage product requirements across current decisions in docs/PRD.md and docs/prd/, mature future plans under docs/plans/, and active implementation under docs/work/. Use whenever the conversation discusses, clarifies, versions, plans, implements, completes, splits, or migrates a product requirement or…

bosens-China/tc39-atlas · 132 tokens

modernize-ecmascript

当 Agent 编写或修改 JavaScript、TypeScript,用户要求按指定环境、输出版本、ES20xx 或具体语法编写代码,询问某项 ECMAScript 语法、标准内置 API 或提案能否采用,或者要求审查仓库中可简化、可现代化的写法时,应使用本 Skill。围绕目标文件真实经过的解析器、转换器和输出目标判断新语法能否安全采用,并按需读取 TC39 Atlas 的提案阶段、官方仓库、polyfill 与实现线索。.

bosens-China/tc39-atlas · 130 tokens

codebase-audit

Audits the current repository for systemic correctness, architecture, churn, simplification, clarity, test value, and operational risks using current source and reproducible probes. It can delegate evidence gathering across bounded capability and perspective lanes. Use when the user runs /codebase-audit or asks for an…

frostney/pascal-mcp-sdk · 70 tokens