Skill Builder

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.

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.

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.

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.

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.

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.