| name | content |
| description | One imperative sentence on what this skill does + concrete trigger conditions. Be pushy — list contexts including ones where the user doesn't name the domain ("even when phrased as 'X' or 'Y'"). Pack relevant keywords. Stay under 1024 characters. |
{{TITLE}}
[One line: what this skill does and when the agent should invoke it.]
Bundled references (load on demand)
[Optional. Only include if you've created references/ files. Each line states a CONCRETE trigger condition, not a vague "see references/".]
references/X.md — read when [concrete trigger condition]
Steps
- [Concrete first step — real commands, real paths.]
- [Next step.]
- [Final step — what "done" looks like.]
Gotchas
[The single highest-leverage section. Concrete corrections to wrong assumptions, not generic advice.]
- [Mistake the agent has made using this skill.]
- [Edge case or non-obvious project-specific fact.]