Skill Builder

Generate Claude Code Skill directories with YAML frontmatter validation.

Updated Oct 22, 2025
One-click install
npx skills add https://github.com/RyanJarv/dockerfiles --skill skill-builder-ryanjarv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/RyanJarv/dockerfiles/tree/main/.claude/skills/skill-builder
Command: npx skills add https://github.com/RyanJarv/dockerfiles --skill skill-builder-ryanjarv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating new Claude Code Skills that are discoverable, efficient, and follow best practices can be complex. This Skill guides you through the entire process, ensuring proper YAML frontmatter, progressive disclosure architecture, and correct directory structure. It simplifies skill development, allowing you to build high-quality, production-ready skills without deep knowledge of the specification.

Core Features & Use Cases

  • Structured Skill Creation: Generate new skill directories and SKILL.md files with correct YAML frontmatter.
  • Progressive Disclosure Guidance: Learn and apply the 3-level disclosure system for optimal context management.
  • Use Case: Quickly create a new custom skill for a specific workflow, ensuring it adheres to all Claude Code specifications, including proper name and description fields, and a well-organized content structure for efficient AI discovery and usage.

Quick Start

Use the Skill Builder skill to create a new skill directory named 'my-first-skill' and then create a basic 'SKILL.md' file within it, including the required name and description.

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 Claude Code Skill with proper YAML frontmatter?

Create a SKILL.md file at your skill's top level with YAML frontmatter containing required `name` (64 characters max) and `description` (1024 characters max) fields. The frontmatter appears between `---` delimiters at the file's start, followed by your skill's markdown content for progressive disclosure.

What directory structure do I need for a production-ready Claude Skill?

Organize your skill with a top-level SKILL.md file and optional subfolders: `scripts/` for automation, `resources/` for assets, and `docs/` for extended documentation. This structure ensures discoverability and autonomous discovery across Claude.ai, Claude Code, SDKs, and API workflows.

What is progressive disclosure in Claude Skill design?

Progressive disclosure organizes skill content into three levels, revealing complexity incrementally. Users encounter essential information first, then deeper details as needed. This reduces cognitive load and improves context efficiency for AI processing and human understanding.

Can I use this to generate skills for both Claude.ai and Claude Code?

Yes. Skill Builder creates skills applicable across Claude.ai, Claude Code, SDKs, and API workflows. The YAML frontmatter, progressive disclosure structure, and directory organization follow unified specifications that work consistently across all platforms.

What happens if my YAML frontmatter doesn't meet the requirements?

Skill Builder validates frontmatter against specifications: `name` and `description` are mandatory, with strict character limits (64 and 1024 respectively). Validation ensures your skill meets production standards and remains discoverable by the Claude system.

Do I need existing YAML or markdown experience to build a skill?

No. Skill Builder guides you through skill creation with templates and structured guidance, so you can build production-ready skills without deep knowledge of YAML syntax or Claude Code specifications.