write-a-skill

Scaffold new agent skills with structured templates, progressive disclosure, and bundled utility scripts. Gather requirements - ask user about: Draft the skill - create: Review with user - present draft and ask: The description is the only thing your agent sees when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request. Goal : Give your agent just enough info to know: Format : Good example : Bad example : The bad example gives your agent no way to distinguish this from other document skills. Add utility scripts when: Scripts save tokens and improve reliability vs generated code. Split into separate files when: After drafting, verify: - 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 - Gather requirements - ask user about: - What task/domain does the skill cover? - What...