skill-creator

To structure an AgentSkill directory, ensure your SKILL.md file contains valid YAML frontmatter with the correct name and description, and organize supporting content into dedicated folders like scripts/ and references/ to maintain spec compliance.

YAML frontmatter in a SKILL.md file must include correctly defined name and description fields. Auditing your skill ensures this metadata is properly parsed and matches the expected AgentSkills specification.

You validate and package an AgentSkill by auditing its directory structure and SKILL.md frontmatter, then following the provided validation workflow to bundle the contents into a distributable .skill archive.

Yes, you can clean up an existing skill directory by auditing its structure, moving content into the correct scripts/ or references/ folders, and removing stale files to ensure it meets the AgentSkills spec.

The best way to audit a skill for spec compliance is to parse the SKILL.md YAML frontmatter for accurate name and description fields, and verify the directory organization follows the expected AgentSkills structure.

AgentSkill validation fails when the directory structure contains extraneous files or lacks proper organization, such as missing scripts/ or references/ folders, or when the SKILL.md YAML frontmatter is incorrectly formatted.