new-skill

Scaffolding a Claude Code skill directory requires generating a SKILL.md file with mandatory frontmatter fields including name, description, argument-hint, and allowed-tools, alongside a conventional directory layout for optional references, scripts, and assets.

Building valid Claude Code skills requires creating a directory structure under .claude/skills that contains a SKILL.md file and optional folders for references, scripts, and assets to ensure proper skill unit organization and metadata consistency.

Required frontmatter fields in a SKILL.md file include name and description, with optional fields like argument-hint and allowed-tools supported by the template to define valid skill units and ensure consistent metadata within Claude Code.

You can automate skill quality checks by applying a standardized blueprint and scaffold for building Claude Code skills, ensuring consistent metadata, documentation, and conventional directory placement within .claude/skills for new capabilities.

The best way to scaffold a Claude Code skill directory is following a standardized template that guides through Phase 1 to Phase 4, generating a ready-to-fill SKILL.md and conventional directory layout for optional references, scripts, and assets.

Building Claude Code skills from scratch is error-prone without a shared template, as teams lack structured guidance for SKILL.md files and a clear workflow, making a standardized blueprint essential for consistent metadata and directory placement.