creating-skills

To create a Claude Code skill, generate a new directory and add a SKILL.md file containing valid YAML frontmatter with a lowercase hyphenated name and non-empty description to ensure proper validation and structure.

A Claude Code skill directory requires a SKILL.md file with valid frontmatter, and optionally supports scripts/, references/, and assets/ directories to organize supplementary code, documentation, and media resources as the skill grows.

Claude Code skills must use lowercase hyphenated names to enforce consistent naming conventions across projects, ensuring the skill definition passes validation checks and integrates properly with the system.

Write a concise Quick Start section in SKILL.md by providing immediate setup steps, such as creating a skill directory, adding required frontmatter, and optionally including references and scripts to speed up skill creation.

Yes, you can optionally add scripts/, references/, and assets/ directories to your Claude Code skill to support easy extension, allowing you to organize executable code, external documentation, and media files as the skill grows.

The best way to standardize Claude Code skill definitions is by applying a reusable template that enforces consistent frontmatter, naming conventions, and a structured body including Quick Start and Core Workflow sections across all projects.