🤖 Advanced Skill Builder

📚 Based on The Complete Guide to Building Skills for Claude by Anthropic

Features • Quick Start • How it works • Documentation

An interactive guide for creating production-ready Claude skills through structured dialogue. Whether you're building your first skill or enhancing an MCP integration, this skill walks you through requirements gathering, planning, YAML frontmatter generation, instruction writing, testing, and iterative refinement.

---

✨ Features

Feature	Description
🎯 Interactive Dialog	Guiding questions help you define your skill requirements step-by-step
📁 Folder Structure Generation	Automatically creates proper skill folder structures (Document, Workflow, MCP)
🔧 YAML Frontmatter Wizard	Generates correct frontmatter with name, description, triggers, and metadata
📝 SKILL.md Generation	Creates well-structured instructions with examples and troubleshooting
🔄 MCP Integration Support	Works with or without MCP servers for enhanced workflows
✅ Validation Checks	Verifies YAML syntax, naming conventions, and structure
🔁 Iterative Refinement	Loop back to improve based on testing feedback

---

🚀 Quick Start

Using with Claude.ai

1. Clone this skill from GitHub
2. Upload to Claude: Settings → Capabilities → Skills → Upload skill
3. Activate: Toggle on the "Advanced Skill Builder" skill
4. Start building: Say "Help me build a skill" or "Create a new skill"

Using with Claude Code

# Clone the repository
git clone https://github.com/John-Dekka/advanced-skill-builder.git

# Place in your Claude Code skills directory
cp -r advanced-skill-builder/advanced-skill-builder ~/.claude/skills/

---

📖 How It Works

The skill builder operates through 5 structured phases:

┌─────────────────────────────────────────────────────────────────┐
│  Phase 1: DISCOVERY                                             │
│  → Ask 5 essential questions about purpose, users, tools, etc.  │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Phase 2: PLANNING                                              │
│  → Recommend skill category & structure based on answers       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Phase 3: STRUCTURE                                             │
│  → Generate folder structure (Document/Workflow/MCP patterns)   │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Phase 4: GENERATION                                            │
│  → Write YAML frontmatter & SKILL.md body with best practices  │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  Phase 5: VALIDATION                                            │
│  → Verify structure, syntax, and provide testing guidance        │
└─────────────────────────────────────────────────────────────────┘

Example Dialogue

You: "Help me build a skill for generating release notes"

Skill Builder: "Great! Let's define your skill. First, what format do you 
want for release notes? Bullet points, sections by type, or detailed changelog?"

You: "Bullet points grouped by type: Features, Bug Fixes, Improvements"

Skill Builder: "How will you provide the commits? GitHub MCP, file upload, 
or pasting them?"

You: "GitHub MCP"

Skill Builder: "Perfect! This is an MCP Enhancement skill. Here's what I'm 
planning:
  
  release-notes-generator/
  ├── SKILL.md
  ├── scripts/
  │   └── categorize-commits.py
  └── references/
      └── commit-patterns.md
  
  Triggers: 'write release notes', 'generate changelog', 'summarize commits'
  
  Does this fit your needs?"

---

📁 Skill Categories

Based on Anthropic's guide, skills fall into three categories:

📄 Category 1: Document & Asset Creation

Use for: Creating consistent, high-quality output documents, presentations, apps, designs, code, etc.

my-document-skill/
├── SKILL.md
├── assets/
│   ├── template-1.md
│   └── template-2.md
└── references/
    └── style-guide.md

Best for: Templates, style guides, quality checklists, brand standards

⚙️ Category 2: Workflow Automation

Use for: Multi-step processes that benefit from consistent methodology

my-workflow-skill/
├── SKILL.md
├── scripts/
│   ├── validate.sh
│   └── process.py
└── references/
    └── error-codes.md

Best for: Step-by-step workflows with validation gates, error handling, rollback

🔌 Category 3: MCP Enhancement

Use for: Adding workflow guidance to MCP tool access

my-mcp-skill/
├── SKILL.md
├── scripts/
│   ├── mcp-validator.py
│   └── error-mapper.py
└── references/
    ├── tool-docs.md
    └── workflow-patterns.md

Best for: Coordinating multiple MCP calls, embedding domain expertise, error patterns

---

🎯 When to Use This Skill

Activate the Advanced Skill Builder when:

User Says...	Or describes...
"Help me build a skill"	A workflow they want to automate
"Create a new skill"	A process to teach Claude
"I need a skill for..."	Specific domain expertise
"How do I create a skill?"	MCP integration workflows
"Build me a skill that..."	Custom triggers and workflows

---

📚 Documentation

Core Documentation

• SKILL.md: The complete skill file with all instructions
• The Complete Guide to Building Skills for Claude: Anthropic's official guide
• references/patterns.md: Common skill patterns

---

Made with PI.DEV because why not? 🥧