skills.rest
33may
33mayCOMMUNITY
Explore all skills by this author →
GitHub

Skill Builder

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

1|1|Updated Nov 28, 2025
Search Tags:#markdown#claude code#skill creation#ai agents#progressive disclosure#skill templates#yaml frontmatter
One-click install
npx skills add https://github.com/33may/robotics --skill skill-builder-33may
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/skill-builder
Command: npx skills add https://github.com/33may/robotics --skill skill-builder-33may

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 Guidance: Documents the required name and description frontmatter fields, character limits, and formatting rules for valid skills. - Progressive Disclosure Architecture: Explains the 3-level loading model (metadata, SKILL.md body, referenced files) so skills scale without context bloat. - Ready-to-Use 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 React components for your team. Use this skill to scaffold the directory, write a compliant SKILL.md, and add scripts and resource templates that Claude can invoke. ## Quick Start Ask Claude to create a new skill called 'my-first-skill' with proper frontmatter and directory structure using the Skill Builder guidelines.

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

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. Restart Claude Code or refresh Claude.ai so the skill is detected.

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.

Can Claude Code skills be nested in subdirectories?▼

No. Skills must be placed directly under ~/.claude/skills/[skill-name]/ or .claude/skills/[skill-name]/. Claude Code does not support nested subdirectories or namespaces for skill discovery.

What is progressive disclosure in Claude skills?▼

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

Why is my skill not appearing in Claude Code?▼

Common causes include missing or malformed YAML frontmatter, the skill directory being nested instead of top-level, or a missing SKILL.md file. Verify the frontmatter starts and ends with --- and restart Claude Code after changes.

Related Skills

Explore More Software Engineering Skills→
astrovilleastroville

convention-writing

Analyzes codebases for recurring patterns and writes standardized convention specs.

Official
Intermediate
k-negishik-negishi
1

skill-manager

Manage Claude Code commands, skills, and agents across shared and project repositories.

Community
Advanced
tokisakiyuutokisakiyuu

write-a-skill

Create new agent skills with proper structure, frontmatter, and bundled resources.

Community
Basic
reggiechan74reggiechan74
5

mcp

Standardize context provisioning to LLMs through the Model Context Protocol.

Community
Advanced