template-skill

To create a new Claude skill with correct metadata, use a standardized skill scaffold that defines the required SKILL.md frontmatter. This ensures consistent discovery and activation of your skill across projects.

SKILL.md frontmatter is standardized metadata required for Claude skills, containing mandatory fields like name and description. You need it whenever you create a new skill under the .claude/skills directory to ensure proper indexing and retrieval.

To structure a Claude skill directory with scripts and references, create a new directory under .claude/skills and add optional folders like scripts/, references/, and assets/. These on-demand resources are loaded at activation according to your SKILL.md instructions.

The best way to standardize skill metadata across multiple projects is to use a reusable skill scaffold that enforces consistent frontmatter formats. This standardization ensures uniform metadata fields for reliable indexing and retrieval across all your skills.

Yes, you can add custom components to a Claude skill template. The scaffold supports extensibility through optional folders such as scripts/, references/, and assets/, allowing you to load specific resources on demand when the skill is activated.

Your Claude skill may not activate properly if the SKILL.md frontmatter is missing mandatory fields like name and description, or if the metadata format is inconsistent. Using a standardized scaffold ensures proper discovery and activation across projects.