skill-creation

Claude Code skills require a SKILL.md file with YAML frontmatter containing name and description fields. The body must stay under 500 lines, with optional scripts/, references/, and assets/ directories for progressive disclosure.

Progressive disclosure in skill creation is a structured packaging approach that layers skill information, using optional scripts/, references/, and assets/ directories to expose details only when needed, reducing cognitive load and keeping the core SKILL.md concise.

Quality assurance for Claude Code skills uses a test-driven approach to review existing skill definitions, checking frontmatter compliance, description clarity, structured anatomy, and Claude Search Optimization alignment to ensure consistency and discoverability across skill taxonomies.

A test-driven development approach is required for skill quality review. This methodology validates new skill definitions and improvements by emphasizing discoverability, progressive disclosure, and structured anatomy to ensure reliable, consistent Claude Code skills.

Optimize a skill for Claude Search Optimization (CSO) by defining clear best practices in the frontmatter description, maintaining structured anatomy, and applying progressive disclosure so the skill is easily discoverable and accurately indexed.

Yes, the SKILL.md body must be under 500 lines. This constraint enforces progressive disclosure, requiring authors to move detailed logic into optional scripts/, references/, and assets/ directories rather than overloading the main definition file.