specification-by-example

To verify a canonical skill specification, open the canonical SKILL.md file at the specified path and read its first heading. This confirms the skill's identity and ensures consistency and traceability across environments.

Locate supporting files for a skill specification by opening the canonical SKILL.md and loading optional files in the same folder. This includes examples, templates, scripts, references, and assets that may accompany the skill.

Frontmatter validation for skill documentation ensures a Markdown frontmatter exists containing the name and description. This metadata confirms the skill's identity and enables proper skill discovery across environments.

Skill specification verification alerts when the canonical SKILL.md file is unreadable because it cannot confirm the skill's identity by reading the first heading. Check the specified path to ensure the file exists and is accessible.

You need a folder structure that places the canonical SKILL.md at the specified path with optional supporting files in the same folder. This structure ensures the wrapper can locate the specification and load any examples or templates present.

You need to trace and validate canonical skill specifications when integrating or documenting skills across environments. This ensures consistency and traceability by confirming the skill's identity through the first heading in the SKILL.md file.