skill-template

To structure a SKILL.md file for Claude Code, you must use a frontmatter-guided blueprint that enforces required fields like name and description, alongside optional components for advanced behavior. This ensures consistent skill discovery and loading.

Required frontmatter fields to create a Claude Code skill include name and description, which are mandatory for reliable loading. You can also populate optional fields to activate advanced behaviors and specify supporting resources.

You standardize skill discovery and activation across a repository by applying a prescriptive SKILL.md template that enforces consistent frontmatter, structure, and safety checks for reliable loading and extension.

Claude Code loads skills automatically or manually based on the standardized markdown guidelines and frontmatter defined in the SKILL.md file. This mechanism ensures reliable activation and extension across projects.

The best way to organize supporting resources like scripts, references, and assets is to follow the standardized SKILL.md markdown guidelines, which document how Claude loads these components automatically or manually.