Skill Builder

Name: Skill Builder
Availability: InStock
Author: dmccarty30

Create Claude Code Skills with YAML frontmatter and directory structure.

4|1|Updated Jul 6, 2025

Search Tags:#skill development #AI tools #markdown #skill creation #Claude skills #YAML #progressive disclosure

Ready to run

npx skills add https://github.com/Dmccarty30/Journeyman-Jobs --skill skill-builder-dmccarty30

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/Dmccarty30/Journeyman-Jobs/tree/main/.claude/skills/skill-builder
Command: npx skills add https://github.com/Dmccarty30/Journeyman-Jobs --skill skill-builder-dmccarty30

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you in creating production-ready Claude Code Skills, ensuring they adhere to the official specification for YAML frontmatter, progressive disclosure, and directory structure. It simplifies the process of building custom, discoverable, and efficient AI tools.

Core Features & Use Cases

YAML Frontmatter Guide: Ensures correct name and description for autonomous skill matching.
Progressive Disclosure: Structures skills to load only necessary context, optimizing performance.
Directory Organization: Provides best practices for organizing scripts, resources, and documentation.
Use Case: When you need to create a new custom skill, use this builder to ensure it's correctly formatted, easily discoverable by Claude, and efficiently loads its content, preventing context overload.

Quick Start

Create a new skill directory and then create a SKILL.md file with the required YAML frontmatter and basic content.

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 structure?▼

Create a skill directory under ~/.claude/skills/[skill-name]/ and add a SKILL.md file with YAML frontmatter containing required `name` (max 64 chars) and `description` (max 1024 chars) fields. This ensures autonomous discovery and correct loading across Claude surfaces.

What is progressive disclosure in skill design and why does it matter?▼

Progressive disclosure loads only necessary context when a skill runs, optimizing performance and preventing context overload. Structure your skill to reveal content gradually so Claude accesses only what's needed for each task.

What directory structure should my custom Claude skill follow?▼

Organize your skill with a top-level directory under ~/.claude/skills/, a SKILL.md file for frontmatter and content, and optional subdirectories for scripts, resources, and documentation. This layout enables autonomous discovery and efficient content loading.

Can I use markdown and YAML to build Claude skills for Claude Code 2.0+?▼

Yes. Claude Code 2.0+ skills use markdown files with YAML frontmatter and support the full directory organization pattern. This combination enables both human-readable documentation and machine-parseable metadata for skill matching and loading.

What happens if my skill's YAML frontmatter is missing required fields?▼

Skills without `name` and `description` fields won't be discovered or loaded autonomously by Claude. These fields are mandatory for skill registration and must meet character limits—name 64 chars max, description 1024 chars max.

How do I organize scripts and resources within a custom skill?▼

Place supporting scripts, resources, and documentation in optional subdirectories within your skill's root folder. This separation keeps your skill modular, maintainable, and ready for both personal and project-scoped use across Claude surfaces.