skill-creator

A Claude Code skill that guides you through building Claude skills — following Anthropic's official best practices from end to end.

What it does

Install this skill once and Claude will know how to:

• Walk you through a structured 7-step creation workflow
• Scaffold a new skill folder with the right structure automatically
• Validate your SKILL.md before you distribute it
• Apply the correct patterns (progressive disclosure, feedback loops, templates)
• Avoid the most common mistakes (vague descriptions, nested references, Windows paths)

Quick start

1. Install the skill

Via Claude.ai:

1. Download or clone this repo
2. Zip the skill-creator/ folder
3. Go to Claude.ai → Settings → Capabilities → Skills → Add skill

Via Claude Code:

git clone https://github.com/pedrom-dev-git/skill-creator

Place the skill-creator/ folder inside your project — Claude Code discovers it automatically.

2. Ask Claude to create a skill

"Quero criar um skill para processar relatórios em PDF"
"Create a skill to automate code reviews"
"Build a skill that generates API documentation from code"

Claude activates the creating-skills skill automatically and guides you through the workflow.

3. Scaffold manually (optional)

# Minimal skill (SKILL.md only)
python skill-creator/scripts/scaffold_skill.py my-skill-name

# Standard (SKILL.md + references/)
python skill-creator/scripts/scaffold_skill.py my-skill-name --type standard

# Full (SKILL.md + scripts/ + references/ + assets/)
python skill-creator/scripts/scaffold_skill.py my-skill-name --type full

4. Validate before distributing

python skill-creator/scripts/validate_skill.py path/to/your-skill/

---

Repository structure

skill-creator/
├── SKILL.md                          # The skill itself
├── scripts/
│   ├── scaffold_skill.py             # Scaffolds a new skill folder
│   └── validate_skill.py             # Validates SKILL.md rules
├── references/
│   ├── yaml-reference.md             # All YAML frontmatter fields
│   ├── patterns.md                   # Design patterns with examples
│   ├── anti-patterns.md              # What to avoid (with examples)
│   └── evaluation-template.json      # Template for testing skills
├── assets/templates/
│   ├── minimal/SKILL.md              # Minimal skill template
│   └── full/                         # Full skill template
│       ├── SKILL.md
│       └── references/
│           └── api-reference.md
├── COMO-USAR.md                      # Full guide in Portuguese
└── README.md                         # This file

---

What the validator checks

python skill-creator/scripts/validate_skill.py my-skill/

Check	Rule
SKILL.md exists	Filename is case-sensitive
name format	Kebab-case, max 64 chars
name reserved words	No "claude" or "anthropic"
description present	Non-empty, max 1024 chars
description person	Must be third person
XML brackets	No < or > in frontmatter
Body length	Under 500 lines recommended
Windows paths	No backslash paths in body

---

Skill creation workflow

- [ ] Step 1: Define scope, name, and triggers
- [ ] Step 2: Choose and scaffold the file structure
- [ ] Step 3: Write SKILL.md (frontmatter + body)
- [ ] Step 4: Add supporting files (scripts, references, assets)
- [ ] Step 5: Validate with validate_skill.py
- [ ] Step 6: Create evaluations and test
- [ ] Step 7: Package and distribute

---

References

• Skill authoring best practices — Anthropic official docs
• Skills overview
• Claude Code skills
• Anthropic skills examples

---

License

MIT