Skill Builder

Create Claude Code Skills with YAML frontmatter and directory structure.

67.5k|8.1k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill skill-builder-ruvnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/ruvnet/claude-flow/tree/main/.claude/skills/skill-builder
Command: npx skills add https://github.com/ruvnet/claude-flow --skill skill-builder-ruvnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude-flow, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the creation of new Claude Code Skills by guiding users through the proper YAML frontmatter, progressive disclosure architecture, and directory organization. It ensures that custom skills are correctly structured for autonomous discovery and use by Claude, reducing the complexity of skill development and empowering you to extend Claude's capabilities.

Core Features & Use Cases

  • YAML Frontmatter Guidance: Ensures correct name and description for optimal skill matching and discovery.
  • Progressive Disclosure Architecture: Structures skills for efficient context loading, scaling to 100+ skills without performance penalty.
  • Directory Organization: Provides templates for scripts/, resources/, and docs/ directories for a complete skill package.
  • Use Case: You have a unique internal tool or workflow that Claude could automate. Use this skill to build a custom Claude Skill for it, ensuring it's discoverable, efficient, and integrates seamlessly into Claude's environment.

Quick Start

1. Create skill directory

mkdir -p ~/.claude/skills/my-first-skill

2. Create SKILL.md with basic frontmatter

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

My First Skill

What This Skill Does

[Your instructions here] EOF

Frequently Asked Questions about Skill Builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom Claude Skill with proper structure?

Create a custom Claude Skill by setting up a directory under ~/.claude/skills/ with a SKILL.md file containing YAML frontmatter (name and description fields) and your skill instructions. This structure ensures Claude can discover and use your skill across Claude Code, Claude.ai, SDK, and API environments.

What is progressive disclosure architecture and why does it matter for skills?

Progressive disclosure architecture structures skills to load context efficiently, allowing Claude to handle 100+ skills without performance degradation. This design pattern ensures your skill integrates seamlessly without slowing down Claude's capability discovery or execution.

Can I organize my skill with scripts and resources directories?

Yes, Skill Builder supports optional directory organization including scripts/, resources/, and docs/ folders within your skill package. This modular structure enables you to bundle automation workflows, reference materials, and documentation alongside your core skill instructions.

Do I need to understand YAML frontmatter to build a skill?

Skill Builder automates YAML frontmatter generation, requiring only two fields: name and description. The skill guides you through proper syntax and placement, so you don't need prior YAML experience to create production-ready skills.

How does skill development work across different Claude platforms?

Custom skills built with Skill Builder work across Claude Code, Claude.ai, SDK, and API by following the unified YAML frontmatter and directory structure standard. This consistency ensures your skill is discoverable and functional regardless of which Claude interface users access it from.

What's the best way to ensure my skill is discoverable by Claude?

Write clear, descriptive YAML frontmatter with a concise name and specific description of when Claude should use your skill. Skill Builder templates demonstrate proper keywords and formatting that enable Claude's skill-matching system to surface your skill in relevant contexts.