
Skill Builder
If you're building custom Claude Code workflows, you'll eventually need to package your own skills, and this walks you through the whole setup. It covers the required YAML frontmatter (name and description fields), progressive disclosure structure, and directory organization that Claude expects. The source shows you exactly where files go (top-level only, no nesting), how to write descriptions that help Claude know when to invoke your skill, and what a complete skill package looks like with scripts and templates. Think of it as the spec and scaffolding tool in one. Most useful when you've hit the limits of existing skills and need something purpose-built for your team's workflow.
- GitHub stars
- 240
- last updated
- Jun 11, 2026
Install
$ npx -y skills add spencermarx/open-code-review --skill 'Skill Builder' --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
# 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)
Sponsors
Details
- Repository
- github.com/spencermarx/open-code-review
- Categories
- DevOps & CI/CD, Git & Pull Requests, Code Review & Quality
- License
- Apache-2.0
- First seen
- Jun 11, 2026
More from spencermarx/open-code-review
All 31- Sparc Methodology
- Stream Chain
- Swarm Advanced
- Swarm Orchestration
- V3 CLI Modernization
- V3 Core Implementation
- V3 DDD Architecture
- V3 Deep Integration
- V3 MCP Optimization
- V3 Memory Unification
- V3 Performance Optimization
- V3 Security Overhaul
- V3 Swarm Coordination
- Verification & Quality Assurance
- AgentDB Advanced Features
- AgentDB Learning Plugins
- AgentDB Memory Patterns
- AgentDB Performance Optimization
- AgentDB Vector Search
- Browser
- Github Code Review
- Github Multi Repo
- Github Project Management
- Github Release Management