$ skilldirectory
— zsh — registry.skilldirectory.dev
skill library blog

home / Agent Skills / Write A Skill Skill by @alirezarezvani

Write A Skill Skill by @alirezarezvani

FREE
github stars★ 29,369updatedOct 2026repo@alirezarezvani
$git clone https://github.com/alirezarezvani/claude-skills

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.

Read the opening of the original SKILL.md
# 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.