Skill Builder

To structure a Claude Code Skill, use YAML frontmatter for metadata and organize files into `scripts/`, `references/`, and `assets/` directories. This architecture ensures skills are discoverable and production-ready across all Claude surfaces.

Progressive disclosure in Claude Code Skills is a 3-level architecture system that manages context and performance efficiently. It controls how skill information is revealed to Claude, ensuring optimal token usage and execution speed during workflows.

Create a custom Claude Code Skill by following structured guidance for YAML frontmatter, directory organization, and progressive disclosure writing. This approach ensures your skill meets specification standards for specific developer workflows.

Yes, you can build production-ready Claude Code Skills without external dependencies. The Skill Builder provides complete guidance for creating self-contained skills using standard YAML frontmatter, directory structures, and content best practices.

The best way to organize a Claude Code Skill directory is to separate components into `scripts/`, `references/`, and `assets/` folders. This structure aligns with progressive disclosure architecture for efficient context management and skill discovery.

Claude Code Skills may fail to load across surfaces if the YAML frontmatter is malformed or the directory structure is incomplete. Following proper skill building specifications with correct progressive disclosure architecture ensures cross-surface compatibility.