write-a-skill
Installation
Summary
Scaffold new agent skills with structured templates, progressive disclosure, and bundled utility scripts.
- Guides skill creation through a four-step process: gather requirements, draft the skill structure, review with user, and finalize
- Provides SKILL.md template with quick start, workflows, and advanced features sections; splits content into separate reference files when exceeding 100 lines
- Includes utility script patterns for deterministic operations like validation and formatting to reduce token overhead
- Emphasizes agent-readable descriptions with specific trigger keywords so the agent knows when to load the skill
SKILL.md
Writing Skills
Process
-
Gather requirements - ask user about:
- What task/domain does the skill cover?
- What specific use cases should it handle?
- Does it need executable scripts or just instructions?
- Any reference materials to include?
-
Draft the skill - create:
- SKILL.md with concise instructions
- Additional reference files if content exceeds 500 lines
- Utility scripts if deterministic operations needed
-
Review with user - present draft and ask:
- Does this cover your use cases?
- Anything missing or unclear?
- Should any section be more/less detailed?