From atopile-dev
How to write and maintain `.claude/skills/*/SKILL.md` files: source-of-truth-first process, verification steps, and conventions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/atopile-dev:atopile-skillsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill describes the process for maintaining the skill documentation under `.claude/skills/*/SKILL.md`.
This skill describes the process for maintaining the skill documentation under .claude/skills/*/SKILL.md.
The goal is that future LLM edits stay accurate, actionable, and grounded in the repo (not vibes).
When updating any skill:
## Quick Start that actually runs in this repo.A good skill doc is:
rg over memory: look for imports, entrypoints, and key classes/functions.Use this hierarchy:
Examples:
src/faebryk/core/solver/README.md + src/faebryk/core/solver/symbolic/invariants.pysrc/faebryk/core/zig/src/graph/graph.zig + src/faebryk/core/zig/src/python/graph/graph_py.zig + generated stubstools/library/gen_F.py is the source-of-truth for _F.pyCommon failure modes in skill docs:
atopile/src/... vs src/...)lsp_server.py vs imaginary server.py)Rule: if you can’t prove it from the repo, either remove it or label it as a hypothesis with a pointer to where to verify.
## Quick StartQuick Start should be:
src/.../something.zigGood patterns:
ato build, ato dev test --llm)GraphView.create() / TypeGraph.create(...))name and description.src/, tools/, and test/ path exists (exclude generated build outputs).rg check).Prefer this ordering:
## Quick Start## Relevant Files## Dependants (Call Sites)## How to Work With / Develop / Test## Best Practices / ## Invariants (when applicable)Keep the doc concise and “repo-local”: avoid external links unless they’re stable standards docs.
npx claudepluginhub mawildoer/atopile-agent-skill --plugin atopile-devGuides creating and editing SKILL.md files for Claude Code skills, covering objectives, when to create, YAML frontmatter requirements, structure, and writing principles like showing patterns with examples.
Guides authoring SKILL.md files for Claude Code: structure, frontmatter fields, invocation controls, argument hints, hooks. Use when creating skills for reference, methodology, or workflows.
Use when creating new skills, restructuring existing skills, or improving skill documentation. Generates SKILL.md + references/ structure with proper patterns.