writing-skills

Progressive disclosure organizes skill documentation by revealing modular instructions and references sequentially. It guides users to deploy only necessary context, reducing cognitive load and maintaining structural guidelines across the repository.

To write a SKILL.md file for Claude skills, define valid YAML frontmatter containing name and description fields, then construct the markdown body. Follow structural guidelines to ensure proper organization, keyword coverage, and cross-referencing for maintainability.

Progressive disclosure in skill documentation organizes content using modular references and scripts to reveal information sequentially. This pattern ensures users access only necessary instructions, maintaining structural guidelines and deployment readiness across the repository.

A valid skill unit does not require dependencies and components, but it must contain a SKILL.md file with YAML frontmatter. The validation process evaluates completeness and outputs precise metadata, noting whether dependencies and components are available.

A skill unit fails a quality check if the SKILL.md file is missing mandatory YAML frontmatter fields like name and description. Validation also fails if structural guidelines, progressive disclosure patterns, or length limits are not properly enforced.