What problem does it solve?
This Skill provides a clear blueprint for creating Claude Skills, including mandatory YAML frontmatter, a consistent directory structure, and best-practice guidance. Use when starting a new skill, updating an existing skill, or learning how Claude Skills are organized and activated.
Core Features & Use Cases
- Frontmatter Validation: Ensures the
name and description fields are present and well-formed, enabling reliable discovery and activation.
- Directory Hygiene: Recommends a standard layout with SKILL.md at the root and optional
scripts/, references/, and assets/ as needed.
- Activation Troubleshooting Guidance: Provides steps to diagnose why a skill isn't triggered or loaded, including common YAML or path issues.
- Migration & Conversion: Guides converting existing documentation into a skill format and upgrading old skills to current conventions.
Quick Start
- Create a new skill folder at
.claude/skills/your-skill-name/
- Add SKILL.md with a valid YAML frontmatter (name, description) and a Markdown body detailing the skill.
- Add optional resources in
scripts/, references/, or assets/ as needed and reference them from SKILL.md.