role-agent-skills

To validate frontmatter fields in SKILL.md files, apply automated audits that enforce required frontmatter fields such as name, description, and allowed-tools, ensuring structure conforms to project conventions and safety standards.

The required frontmatter fields for a SKILL.md file are name, description, and allowed-tools. Enforcing these specific frontmatter fields ensures consistent structure and safe loading by agents.

You can enforce authoring standards for Markdown skill files by applying quality gates that audit directories like plugins/**/skills/**, validating frontmatter and ensuring progressive disclosure patterns are followed during creation or modification.

This skill validation process requires no external dependencies, operating as a standalone quality gate to audit and enforce SKILL.md conventions without needing additional packages or environments.

Your SKILL.md file fails project quality gates when it lacks required frontmatter fields like name, description, or allowed-tools, or when it violates progressive disclosure patterns and Markdown best practices expected by the validation agent.

Progressive disclosure in skill authoring is a structural pattern that guides maintainers to reveal information incrementally within SKILL.md files, aligning with project quality gates to ensure safe and consistent agent loading.