What problem does it solve?
Creating new Claude Code Skills with the correct structure and metadata can be complex, hindering custom automation. This Skill simplifies the process by guiding you through building production-ready Skills with proper YAML frontmatter, progressive disclosure, and complete directory organization, enabling you to quickly extend Claude's capabilities.
Core Features & Use Cases
- YAML Frontmatter Guidance: Ensures correct
name (max 64 chars) and description (max 1024 chars) with "what" and "when" clauses for optimal autonomous matching.
- Progressive Disclosure Architecture: Helps structure
SKILL.md and related files (scripts/, resources/, docs/) to optimize context loading and avoid penalties.
- Directory Structure Enforcement: Guides on correct skill placement (
~/.claude/skills/ or .claude/skills/) and organization for discoverability.
- Use Case: You need a custom Skill to automate a very specific internal report generation process. Use Skill Builder to create the
SKILL.md with the right metadata, organize your scripts/ for data extraction and formatting, and ensure Claude can autonomously discover and execute it.
Quick Start
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
