skill-builder

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

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]"

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)

1. Design Structure (architect agent)

- Plan YAML frontmatter fields

- Design skill organization (single vs multi-file)

- Calculate token budget allocation

- Choose appropriate templates

1. 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

1. 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

1. Create Tests (tester agent)

- Define activation test cases

- Create edge case validations

- Document expected behaviors

• 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](./examples.md) for detailed examples of each type.

For explicit invocation:

```bash

/amplihack:skill-builder

```

Examples in [examples.md](./examples.md).

Supporting Files (progressive disclosure):

• [reference.md](./reference.md): Architecture, patterns, YAML spec, best practices
• [examples.md](./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.