create-skill

Scaffolding a new Claude Code skill directory requires creating SKILL.md, skill.yaml, validations.yaml, sharp-edges.yaml, and collaboration.yaml. This automation generates all canonical YAML files under .claude/skills/{folder-name}/ and wires a Stop hook to validate the skill structure.

A Claude Code skill setup requires SKILL.md, skill.yaml, validations.yaml, sharp-edges.yaml, and collaboration.yaml. The scaffolding automation enforces folder-name consistency with the SKILL.md frontmatter name to ensure proper skill discovery.

A new Claude Code skill needs a validation hook to enforce the canonical validation flow. The scaffolding process wires a Stop hook to the validate-skill target, ensuring the generated YAML definitions pass structural validation before the skill is used.

Automating the folder structure for Claude Code skills is supported by running the scaffold tool for each new skill. It creates the canonical multi-YAML layout under .claude/skills/{folder-name}/ and enforces folder-name matching the SKILL.md frontmatter name for consistent discovery.

The Claude Code skill folder name must match the SKILL.md frontmatter name to ensure consistent skill discovery. The scaffolding automation enforces this naming constraint, preventing mismatches that could cause the skill to be overlooked during search and execution.

The best way to structure a Claude Code skill for devops automation is using the canonical multi-YAML layout. This approach separates skill definitions, validation rules, sharp edges, and collaboration guidelines into distinct files, with a Stop hook enforcing validation.