Writing Skills

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

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?