skill-builder

Skill Builder

Purpose

Helps users create production-ready Claude Code skills that follow best practices from official Anthropic documentation and amplihack's ruthless simplicity philosophy.

When I Activate

I automatically load when you mention:

• "build a skill" or "create a skill"
• "generate a skill" or "make a skill"
• "design a skill" or "develop a skill"
• "skill builder" or "new skill"
• "skill for [purpose]"

What I Do

I orchestrate the skill creation process using amplihack's specialized agents:

1. Clarify Requirements (prompt-writer agent)

   • Understand skill purpose and scope
   • Define target users and use cases
   • Identify skill type (agent, command, scenario)

2. Design Structure (architect agent)

   • Plan YAML frontmatter fields
   • Design skill organization (single vs multi-file)
   • Calculate token budget allocation
   • Choose appropriate templates

3. Generate Skill (builder agent)

   • Create SKILL.md with proper YAML frontmatter
   • Write clear instructions and examples
   • Include supporting files if needed
   • Follow progressive disclosure pattern

4. Validate Quality (reviewer agent)

   • Check YAML frontmatter syntax
   • Verify token budget (<5,000 tokens core)
   • Ensure philosophy compliance (>85% score)
   • Test description quality for discovery

5. Create Tests (tester agent)

   • Define activation test cases
   • Create edge case validations
   • Document expected behaviors

Skill Types Supported

• skill: Claude Code skills in ~/.amplihack/.claude/skills/ (auto-discovery)
• agent: Specialized agents in ~/.amplihack/.claude/agents/amplihack/specialized/
• command: Slash commands in ~/.amplihack/.claude/commands/amplihack/
• scenario: Production tools in ~/.amplihack/.claude/scenarios/

See examples.md for detailed examples of each type.

Command Interface

For explicit invocation:

/amplihack:skill-builder <skill-name> <skill-type> <description>

Examples in examples.md.

Documentation

Supporting Files (progressive disclosure):

• reference.md: Architecture, patterns, YAML spec, best practices
• examples.md: Real-world usage, testing, troubleshooting

Original Documentation Sources (embedded in reference.md):

1. Official Claude Code Skills: https://code.claude.com/docs/en/skills
2. Anthropic Agent SDK Skills: https://docs.claude.com/en/docs/agent-sdk/skills
3. Agent Skills Engineering Blog: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
4. Claude Cookbooks - Skills: https://github.com/anthropics/claude-cookbooks/tree/main/skills
5. Skills Custom Development Notebook: https://github.com/anthropics/claude-cookbooks/blob/main/skills/notebooks/03_skills_custom_development.ipynb
6. metaskills/skill-builder (Reference): https://github.com/metaskills/skill-builder

All documentation is embedded in reference.md for offline access. Links provided for updates and verification.

Note: This skill automatically loads when Claude detects skill building intent. For explicit control, use /amplihack:skill-builder.