Create New Skills

To create Agent Skills for Claude Code, you can scaffold a new directory in .claude/skills/, add a SKILL.md file with required YAML frontmatter, and use progressive disclosure to structure supporting resources and documentation.

Progressive disclosure is a structuring pattern that separates core instructions in SKILL.md from optional supporting files, ensuring Claude loads only necessary context to execute domain knowledge efficiently.

You validate YAML frontmatter by ensuring the required name and description fields are present and correctly formatted in your SKILL.md file, following enforced validation workflows to maintain consistent skill quality.

The best way to package domain knowledge is following a guided workflow from planning to validation, creating structured templates, adding documentation references, and publishing the skill within your repository.

No dependencies are required to start creating Agent Skills. You only need a repository to scaffold the skill directory structure and a text editor to define the SKILL.md frontmatter and optional resources.

Frontmatter validation fails when the required name and description fields are missing or malformed in the SKILL.md file. Enforcing these metadata fields ensures consistent skill quality and proper agent execution.