skill-builder

name	skill-builder
version	1.0.0
description	Creates, refines, and validates Claude Code skills following amplihack philosophy and official best practices. Automatically activates when building, creating, generating, or designing new skills.

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.