name	skill-builder
description	Use when user asks to "create a skill", "build a skill", or "design a skill". Guides through requirements, solution design, and implementation of token-efficient Claude Code skills.

Skill Builder

Create high-quality, token-efficient Claude skills.

Current structure: !tree -L 1 ~/.claude/skills/skill-builder -I 'example-*'

Quick Mode vs. Guided Mode

Quick Mode (for simple skills):

Ask: Purpose, trigger conditions, freedom level
Use template.md and create immediately

Guided Mode (for complex skills): Follow 3-phase process below

Guided Process

Phase 1: Requirements (3 questions max)

What & When: Purpose and trigger conditions
Freedom level: High (creative) / Medium (pattern) / Low (scripted)
Scope: Personal (~/.claude/skills) or project (.claude/skills)

Phase 2: Propose Pattern

Choose based on complexity:

Simple (<200 lines): Single SKILL.md | See example-simple.md
Modular (needs examples): SKILL.md + supporting files | See example-modular.md
Scripted (fragile ops): Add helper scripts | See example-scripted.md

Phase 3: Create

Create directory and SKILL.md using template.md
Add supporting files if modular/scripted
Verify: description has triggers, TOC added if >100 lines

Critical Rules

- Description MUST include trigger conditions ("Use when user asks to...") - Files >100 lines MUST have table of contents - One level deep only (SKILL.md → supporting files, no subdirectories) - SKILL.md should be <200 lines - Use reference.md not @reference.md (load on-demand)

Resources

Examples (real-world patterns):

example-simple.md - Single file, high freedom
example-modular.md - Multi-file with examples
example-scripted.md - Helper scripts for fragile ops

Guides (details on-demand):

template.md - Blank SKILL.md starter
patterns.md - Common patterns and anti-patterns
reference.md - Complete options reference

Install Skill

SKILL.md