Skill Builder

Skill Builder

Behavioral Classification

Type: Guided Decision

This skill guides you through key decisions when creating skills, then generates appropriate templates and structure.

Decision Points:

1. What type of skill? (basic, intermediate, advanced)
2. Behavioral classification? (autonomous, guided, interactive, configurable)
3. Include scripts? (yes/no)

After decisions are made, skill generation proceeds automatically.

What This Skill Does

Creates production-ready Claude Code Skills with proper YAML frontmatter, progressive disclosure architecture, and complete file/folder structure. This skill guides you through building skills that Claude can autonomously discover and use across all surfaces (Claude.ai, Claude Code, SDK, API).

Key Features:

• Proper YAML frontmatter with required name and description fields
• Progressive disclosure (3-level system for scaling to 100+ skills)
• Directory structure templates for minimal to full-featured skills
• Scripts and resources organization patterns

Prerequisites

• Claude Code 2.0+ or Claude.ai with Skills support
• Basic understanding of Markdown and YAML
• Text editor or IDE

Quick Start

Creating Your First Skill

# 1. Create skill directory (MUST be at top level, NOT in subdirectories!)
mkdir -p ~/.claude/skills/my-first-skill

# 2. Create SKILL.md with proper format
cat > ~/.claude/skills/my-first-skill/SKILL.md << 'EOF'
---
name: "My First Skill"
description: "Brief description of what this skill does and when Claude should use it. Maximum 1024 characters."
---

# My First Skill

## What This Skill Does
[Your instructions here]

## Quick Start
[Basic usage]
EOF

# 3. Verify skill is detected
# Restart Claude Code or refresh Claude.ai

Sub-Documentation

For detailed information, see the following files:

Quick Reference

YAML Frontmatter (Required)

---
name: "Skill Name"                    # REQUIRED: Max 64 chars
description: "What this skill does    # REQUIRED: Max 1024 chars
and when Claude should use it."       # Include BOTH what & when
---

Directory Structure

Minimal (Required):

~/.claude/skills/my-skill/
└── SKILL.md                     # REQUIRED

Full-Featured (Recommended):

~/.claude/skills/my-skill/
├── SKILL.md                     # REQUIRED: Main skill file
├── README.md                    # Optional: Human-readable docs
├── scripts/                     # Optional: Executable scripts
├── resources/                   # Optional: Templates, examples
└── docs/                        # Optional: Additional documentation

Skills Locations

Behavioral Classifications

Progressive Disclosure

Learn More

Official Resources

• Anthropic Agent Skills Documentation
• GitHub Skills Repository
• Claude Code Documentation

Community

• Skills Marketplace - Browse community skills
• Anthropic Discord - Get help from community

Created: 2025-10-19 Version: 1.0.0 Maintained By: agentic-flow team