write-a-skill

v2.9.0

Skill-author skill: create new agent skills with proper structure, progressive disclosure, and bundled resources. Enhanced from Matt Pocock's MIT-licensed write-a-skill (https://github.com/mattpocock/skills) with: (1) stdlib Python validation tools (description validator, structure validator, review-checklist runner), (2) 3 reference docs citing 5+ authoritative sources each (progressive disclosure principles, description design patterns, quality gates), (3) cs-skill-author persona agent + /cs:write-a-skill slash command. Matt's voice and 3-phase workflow (Gather → Draft → Review) preserved verbatim per his MIT license. Use when user wants to create, write, build, or author a new agent skill.

Claude Code1 skill

by Alireza RezvaniMIT24.2kupdated 10 hours ago

Source

$ git clone https://github.com/alirezarezvani/claude-skills

Clone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is engineering/write-a-skill/ inside the repository.

Layout

engineering/write-a-skill/

├── .claude-plugin/plugin.json
└── skills/write-a-skill/SKILL.md

Skills1

write-a-skillskills/write-a-skill/SKILL.md

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.

Manifests1

engineering/write-a-skill/.claude-plugin/plugin.json

{
  "name": "write-a-skill",
  "description": "Skill-author skill: create new agent skills with proper structure, progressive disclosure, and bundled resources. Enhanced from Matt Pocock's MIT-licensed write-a-skill (https://github.com/mattpocock/skills) with: (1) stdlib Python validation tools (description validator, structure validator, review-checklist runner), (2) 3 reference docs citing 5+ authoritative sources each (progressive disclosure principles, description design patterns, quality gates), (3) cs-skill-author persona agent + /cs:write-a-skill slash command. Matt's voice and 3-phase workflow (Gather → Draft → Review) preserved verbatim per his MIT license. Use when user wants to create, write, build, or author a new agent skill.",
  "version": "2.9.0",
  "author": {
    "name": "Alireza Rezvani",
    "url": "https://alirezarezvani.com"
  },
  "homepage": "https://github.com/alirezarezvani/claude-skills/tree/main/engineering/write-a-skill",
  "repository": "https://github.com/alirezarezvani/claude-skills",
  "license": "MIT",
  "skills": [
    "./skills/write-a-skill"
  ],
  "attribution": {
    "derived_from": "https://github.com/mattpocock/skills/tree/main/skills/productivity/write-a-skill",
    "original_author": "Matt Pocock (@mattpocock)",
    "original_license": "MIT",
    "derivation_note": "Matt's SKILL.md content reproduced under MIT. Additions: stdlib validation tools, deep references, cs-* persona agent + /cs:* command wrapper. Matt's voice and 3-phase workflow preserved verbatim."
  }
}