write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, build, or author a new skill.
Target: Target not categorized. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Writing Skills
- Process
- Skill Structure
- SKILL.md Template
- Description Requirements
- When to Add Scripts
- When to Split Files
- Review Checklist
Derived from Matt Pocock's write-a-skill (MIT). Matt's voice and 3-phase workflow preserved verbatim. Additions: validation tools + references + cs- wrapper (see Tooling + Companions below). 1. 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? 2. Draft the skill - create: SKILL.md with concise instructions Additional reference files if content exceeds 500 lines Utility scripts if deterministic operations needed 3. Review with user - present draft and ask: Does this cover your use cases? Anything missing or unclear? Should any section be more/less detailed? 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: 1. What capability this skill provides 2. When/why to trigger it (specific keywords, contexts, file types) Format: Max 1024 chars Write in third person First sentence: what it do
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- alirezarezvani/claude-skills
- Source file
- engineering/write-a-skill/skills/write-a-skill/SKILL.md
- Fixed revision
- 8f082544116fc0d014188e521ca40304cdfc86b0
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: alirezarezvani/claude-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-09T14:01:46.942Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.