skill-authoring

Progressive disclosure in SKILL.md guidelines separates metadata, body, and referenced materials to ensure reliable loading and discovery. It defines where to store guidelines and references for consistent behavior.

To create a new skill directory, add a SKILL.md file with frontmatter containing a valid name and description, then implement the body to load on trigger. Directory layout guidance enforces this structure.

The required frontmatter for a SKILL.md file includes a valid name and description. Enforcing these frontmatter requirements during skill authoring ensures consistent discovery and reliable behavior across all skill units.

Yes, the skill authoring framework applies across chezmoi source forms. It enforces frontmatter requirements, progressive disclosure guidelines, and directory layout rules to validate skills and avoid common pitfalls during editing.

The best way to refine SKILL.md documentation is to validate frontmatter requirements and check directory layout rules. Applying progressive disclosure guidelines during review ensures consistent discovery and avoids common authoring pitfalls.