skills-scaffolding

Creating a Claude Code skill requires a SKILL.md file with YAML frontmatter containing name and description, plus optional bundled resources in scripts/, references/, and assets/ directories. skills-scaffolding provides the exact file structure, metadata conventions, and bundling patterns needed to build discoverable, well-organized skills that Claude can use effectively.

A skill is a persistent, reusable knowledge package with bundled resources and YAML metadata that transforms Claude into a specialized agent; a slash command is a simpler, single-purpose trigger. skills-scaffolding teaches this distinction and guides you toward the right packaging approach for your use case.

Organize resources into skill subdirectories: scripts/ for executable code, references/ for documentation and assets, and assets/ for supporting files. skills-scaffolding specifies the exact directory layout and naming conventions that ensure Claude locates and uses bundled resources efficiently during skill execution.

Yes. skills-scaffolding guides skill updates and reorganization workflows, helping you refactor YAML frontmatter, restructure bundled resources, and improve documentation within existing skills while maintaining compatibility and discoverability.

Write clear, imperative instructions optimized for context efficiency using progressive disclosure—structuring information so Claude accesses only what it needs. skills-scaffolding provides content guidelines, frontmatter templates, and examples that maximize skill clarity and minimize token overhead.

YAML frontmatter requires name and description fields at minimum; skills-scaffolding specifies all required and optional metadata fields, their formats, and how they affect skill discoverability and Claude's ability to locate and apply your skill correctly.