skill-builder

Generate Claude Skills with SKILL.md frontmatter and directory structure.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/paulingham/.claude --skill skill-builder-paulingham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/paulingham/.claude/tree/main/skills/skill-builder
Command: npx skills add https://github.com/paulingham/.claude --skill skill-builder-paulingham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill Builder provides a clear blueprint and templates to create production-ready Claude Skills with proper YAML frontmatter, progressive disclosure architecture, and a clean, repeatable directory layout. It ensures consistency across skill discovery and onboarding.

Core Features & Use Cases

  • Generates ready-to-use SKILL.md frontmatter with required fields (name and description) and clear length guidance.
  • Defines a 4-level progressive disclosure structure (Metadata, SKILL.md Body, References/Assets) to scale skill guidance.
  • Provides complete directory templates for both personal and project skills, including minimal and full-featured structures, with recommended file layout and naming conventions.

Quick Start

Create a new production-ready Claude Skill by adding SKILL.md with proper frontmatter and a progressive disclosure structure under your ~/.claude/skills/ directory.

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

To create a production-ready Claude Skill, generate a SKILL.md file with YAML frontmatter containing required name and description fields. This ensures proper skill discovery and consistent onboarding across Claude surfaces like Claude Code and Claude.ai.

What is progressive disclosure architecture in Claude Skills?

Progressive disclosure architecture in Claude Skills structures guidance across four levels: Metadata, SKILL.md Body, and References or Assets. This pattern scales skill guidance efficiently by revealing complexity only as needed during skill development.

How do I structure a Claude Skill directory for both personal and project use?

Structure a Claude Skill directory by placing SKILL.md at the skill root under your ~/.claude/skills/ directory. Use provided directory templates to organize optional components like scripts, references, and assets with recommended file layouts and naming conventions.

Do I need to include optional components like scripts and references when building a Claude Skill?

Optional components like scripts, references, and assets are not required to build a Claude Skill. You only need SKILL.md with valid YAML frontmatter at the root, adding optional components as needed to support progressive disclosure patterns.

Why does my Claude Skill require specific YAML frontmatter fields?

Claude Skills require YAML frontmatter with name and description fields to ensure consistent skill discovery and onboarding across surfaces like Claude Code, Claude.ai, SDK, and API. This enforces a clean, repeatable directory layout for production use.

What is the best way to scale skill guidance for complex Claude workflows?

The best way to scale skill guidance is implementing a 4-level progressive disclosure structure using SKILL.md, references, and assets. This approach manages complexity by separating Metadata, Body, and References, ensuring guidance scales cleanly.