document-skills

Standardizing SKILL.md files requires enforcing project-specific structures and best practices, ensuring correct frontmatter, section ordering, and progressive disclosure principles are applied to improve AI agent usability and maintainability.

Best practices for skill development documentation include enforcing consistent structure, naming conventions, and correct frontmatter configuration, while integrating official guidelines for progressive disclosure to improve discoverability and usability.

Add frontmatter and correct section ordering to a SKILL.md file by applying an automated standardization workflow that enforces project-specific structures, adds necessary sections, and ensures configuration aligns with official documentation.

You need to use progressive disclosure principles in skill documentation when creating new skills or updating existing ones, ensuring AI agents can efficiently parse information through correctly ordered sections and standardized frontmatter.

You can automatically format and update existing SKILL.md files to meet project conventions by running a standardization process that checks frontmatter configuration, enforces section ordering, and applies progressive disclosure principles.