What problem does it solve?
Skills are structured knowledge packs that teach the agent how to handle specific domains. This guide helps teams create, organize, and maintain Claude Skills with consistent naming, structure, and discovery, reducing confusion and ensuring reusability across projects.
Core Features & Use Cases
- Frontmatter defines skill identity (name + description) used for discovery and activation.
- SKILL.md body contains core instructions loaded into context upon activation.
- Optional directories (references/, scripts/, assets/) load on demand as directed by SKILL.md.
- Naming and structure rules ensure a uniform catalog and predictable loading.
- Skills can be loaded on demand and combined with references/scripts/assets for richer behavior.
Quick Start
Create a new skill folder under skills/ named my-new-skill, add SKILL.md with proper frontmatter, and place any references, scripts, or assets as needed.