claude-code-skills

Claude Code skills require a SKILL.md file with frontmatter metadata, a resources folder, and a data/sources.json file. Use kebab-case naming, keep descriptions under 200 characters, and organize resources by progressive disclosure—metadata at the top level, detailed content in nested resources. This standardized structure ensures consistency across multi-folder projects.

Progressive disclosure surfaces essential information first, then reveals complexity on demand. In Claude Code skills, this means frontmatter and quick-start sections upfront, followed by detailed resources, examples, and advanced patterns nested deeper. This approach reduces cognitive load and lets users find answers at their own pace.

Yes. This skill provides templates and patterns specifically for multi-folder skill projects. Use the SKILL.md frontmatter schema, resources organization, and data/sources.json validation requirements as a reference. A quality checklist ensures each skill folder follows the same modular architecture and naming conventions.

The sources.json file validates and documents data sources used by your skill. It follows a defined schema that ensures data integrity and consistency. Include source metadata, references, and any dependencies your skill relies on for its core functions.

Organize resources using progressive disclosure: place quick-start and overview content in SKILL.md, then structure deeper resources by complexity level. Use clear naming and progressive nesting so beginners find immediate answers while advanced users access specialized patterns, validation templates, and architectural details without clutter.