skills.rest
pjherron
pjherronCOMMUNITY
Explore all skills by this author →
GitHub

Skill Builder

Create Claude Code Skills with YAML frontmatter and progressive disclosure structure.

Updated Jul 16, 2026
Search Tags:#templates#claude code#skill creation#ai agents#progressive disclosure#skill.md#yaml frontmatter
One-click install
npx skills add https://github.com/pjherron/hypoc --skill skill-builder-pjherron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/pjherron/hypoc/tree/main/hypoc/skills/skill-builder
Command: npx skills add https://github.com/pjherron/hypoc --skill skill-builder-pjherron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building custom Claude Code Skills requires knowing the exact SKILL.md format, YAML frontmatter rules, and directory conventions, and mistakes in any of these prevent Claude from discovering or loading the skill. ## Core Features & Use Cases - Specification Reference: Documents the required name and description frontmatter fields, character limits, and formatting rules for valid skills. - Progressive Disclosure Guidance: Explains the 3-level loading architecture so skills scale to 100+ installs without context bloat. - Ready-Made Templates: Provides basic, intermediate, and advanced skill templates plus real-world examples for documentation and code generation skills. - Use Case: You want to build a custom skill that generates API documentation for your team. Use this Skill to scaffold the directory, write a compliant SKILL.md, and validate it against the checklist before publishing. ## Quick Start Ask the AI to create a new Claude Code skill for your workflow using the skill-builder specification and templates.

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 custom Claude Code skill?▼

Create a directory directly under ~/.claude/skills/ or .claude/skills/ in your project, then add a SKILL.md file with YAML frontmatter containing name and description fields. The markdown body below the frontmatter holds the instructions Claude loads when the skill activates.

What fields are required in SKILL.md frontmatter?▼

Only two fields are required: name (maximum 64 characters) and description (maximum 1024 characters). The description should state both what the skill does and when Claude should invoke it. Additional fields are ignored by Claude.

Can Claude Code skills be nested in subdirectories?▼

No, Claude Code does not support nested subdirectories or namespaces for skills. Each skill directory must sit directly under ~/.claude/skills/ for personal skills or .claude/skills/ at the project root for team-shared skills.

What is progressive disclosure in Claude skills?▼

Progressive disclosure is a three-level loading system: name and description load at startup for all skills, the SKILL.md body loads only when the skill triggers, and referenced files load on demand. This lets you install 100+ skills with minimal context usage.

Why is my Claude skill not being detected?▼

Common causes include placing the skill in a nested subdirectory, YAML syntax errors in the frontmatter, missing name or description fields, or exceeding character limits. Restart Claude Code after adding the skill and verify the directory sits at the top level of .claude/skills/.

Related Skills

Explore More Software Engineering Skills→
gnuriognurio
19

assess-fitness

Produce GO/NO-GO recommendations for spreading classified ideas.

Community
Intermediate
Starchild-ai-agentStarchild-ai-agent
1

@554/skill-installer

Discover, install, and publish AI agent skills from marketplaces via API and CLI.

Official
Intermediate
takemi-ohamatakemi-ohama

skill-stats

Analyzes Claude Code transcript JSONL files to extract per-skill usage statistics including invocations, triggers, and hits across projects and time ranges.

Community
Intermediate
secondskysecondsky
204

openai-responses

Manage stateful AI conversations and tool-driven workflows via OpenAI Responses API and MCP servers.

Community
Advanced