Skill Builder
Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, generate skill templates, or understand the Claude Skills specification.
Profile →npx skills add ruvnet/ruflo --skill skill-builder --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Skill Builder ## 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). ## 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 ```bash # 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 ``` --- ## Complete Specification ### 📋 YAML Frontmatter (REQUIRED) Every SKILL.md **must** start with YAML frontmatter containing exactly two require
- What This Skill Does
- Prerequisites
- Quick Start
- Creating Your First Skill
- Complete Specification
- 📋 YAML Frontmatter (REQUIRED)
- 📂 Directory Structure
- 🎯 Progressive Disclosure Architecture
- 📝 SKILL.md Content Structure
- 🎨 Content Best Practices
- 🛠️ Adding Scripts and Resources
- 🔗 File References and Navigation
- ✅ Validation Checklist
- Skill Builder Templates
mkdir -p ~/.claude$skills$my-first-skill cat > ~/.claude$skills$my-first-skill/SKILL.md << 'EOF' Restart Claude Code or refresh Claude.ai In skill directory scripts/ resources/
What does the Skill Builder skill do?
Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, generate skill templates, or understand the Claude Skills specification.
How do I install it?
Run `npx skills add ruvnet/ruflo --skill skill-builder --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ruvnet/ruflo, a repository with 67,015 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.