example-skill

A compliant agent skill scaffold validates that a SKILL.md file contains correct frontmatter and a populated references directory with acceptance criteria and analysis notes. It checks that optional components like scripts and assets exist only when populated.

Validate SKILL.md frontmatter by ensuring it includes the required name and description fields, then confirm the references directory exists with acceptance criteria and analysis notes. Optional scripts and assets directories should only be present when populated with files.

Yes, the skill scaffold serves as a regression-testing fixture for maturity checks by providing a gold-standard example of a compliant SKILL.md structure, allowing teams to validate tooling against canonical frontmatter and reference directories.

Use a gold-standard skill scaffold as a template for new skill scaffolding and educational demonstrations. Review its SKILL.md frontmatter, references directory, acceptance criteria, and analysis notes to understand the canonical structure before generating new skills.

Optional directories like scripts and assets should be included in a skill scaffold only when they are populated with files. A compliant structure requires the references directory to exist, but optional components must not be present if they are empty.

Yes, a compliant skill scaffold requires the references directory to contain both acceptance criteria and analysis notes. These files guide evaluators and ensure the skill structure meets the required maturity checks.