skills sourced live from GitHub · all skills listed are free · each skill is provided under its author's license.
home / Agent Skills / Write A Skill Skill by @alirezarezvani
The skill is the engineering/write-a-skill/skills/write-a-skill folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.
Create new agent skills with proper structure, progressive disclosure, and bundled resources.
Walks through creating a new agent skill with proper structure, progressive disclosure and bundled resources, and includes a SKILL.md template.
The original SKILL.md is organised into these sections:
Written and maintained by @alirezarezvani. It is published under the MIT license, which allows reuse with attribution. See the author profile. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.
# Writing Skills > Derived from [Matt Pocock's write-a-skill](https://github.com/mattpocock/skills/tree/main/skills/productivity/write-a-skill) (MIT). Matt's voice and 3-phase workflow preserved verbatim. Additions: validation tools + references + cs-* wrapper (see *Tooling + Companions* below). ## Process 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? ## Skill Structure ``` skill-name/ ├── SKILL.md # Main instructions (required) …
Excerpt only, quoted from the author's repository. Open the repository for the complete file.