Write A Skill

This is a meta skill that helps you create new Claude Code skills by generating the proper structure and documentation. You'd use it when you want to build a custom skill but aren't sure about the format or what fields to include. It essentially bootstraps the skill creation process, which is handy if you're new to the ecosystem or just want to move faster. The irony of needing a skill to write skills isn't lost on me, but it does lower the barrier to entry for extending Claude's capabilities in your own workflow.

skills.sh installs: 395
GitHub stars: 29.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add alirezarezvani/claude-skills --skill write-a-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

Writing Skills

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).

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?

Skill Structure

skill-name/
├── SKILL.md           # Main instructions (required)
├── REFERENCE.md       # Detailed docs (if needed)
├── EXAMPLES.md        # Usage examples (if needed)
└── scripts/           # Utility scripts (if needed)
    └── helper.js