write-a-skill
Installation
SKILL.md
Write a Skill
Create structured agent skills with proper documentation.
When to use this skill
- Formalizing a workflow into a reusable, shareable skill
- Building new agent capabilities from scratch
- Documenting existing patterns so agents can discover and use them
Critical design principle
The description field is the only thing your agent sees when deciding which skill to load.
Write descriptions that:
- Clearly state what the skill does
- Include specific triggers: "Use when [context]"
- Have a 1024-character maximum
- Are precise enough that the agent knows whether to activate