Skill Creator

Create and optimize Claude Code skills -- modular packages providing specialized workflows, tool integrations, and domain expertise.

Skill Structure

.claude/skills/skill-name/ SKILL.md # Required. <100 lines. Quick reference. references/ # Docs loaded on-demand (also <100 lines each) scripts/ # Executable code (Node.js/Python preferred) assets/ # Output files (templates, images, fonts)

For detailed format spec, frontmatter fields, and file organization: ⚠️ MUST READ: .claude/skills/skill-plan/references/skill-structure-guide.md

Creation Workflow

• Understand -- Gather concrete usage examples; ask clarifying questions

• Plan -- Identify reusable resources (scripts, references, assets) from examples

• Initialize -- Run scripts/init_skill.py <name> --path <dir> for scaffold

• Implement -- Write SKILL.md (<100 lines), create references/scripts/assets

• Package -- Run scripts/package_skill.py <path> to validate and zip

Constraints

• SKILL.md must be <100 lines (frontmatter + body)

• References/ files also <100 lines each; split further if needed

• Progressive disclosure: heavy content in references/, not SKILL.md

• Combine related topics into one skill (e.g., cloudflare-* -> devops)

• Imperative writing style ("Create X" not "You should create X")

• No "Task Planning Notes" boilerplate

• Scripts: prefer Node.js/Python, include tests, respect .env loading order

Writing SKILL.md

• Purpose statement (1-2 lines)

• Decision tree or workflow steps (concise, <5 lines per step)

• Read: directives to references/ for detailed guidance

• No inline code examples >5 lines -- move to references/

Quality Gate

Before finalizing, validate against checklist: ⚠️ MUST READ: .claude/skills/skill-plan/references/skill-quality-checklist.md

Iteration

After using a skill on real tasks, watch for: Claude re-discovering known info, ignoring bundled scripts, false triggers, or missed triggers. Update SKILL.md, description keywords, or references accordingly.

IMPORTANT Task Planning Notes (MUST FOLLOW)

• Always plan and break work into many small todo tasks using TaskCreate

• Always add a final review todo task to verify work quality