skill-creator

To create an agent skill, use a structured template to build a SKILL.md file with proper frontmatter, then organize optional resources like references, scripts, and assets into their designated directories to ensure standardized skill development.

Auditing agent skills involves validating the SKILL.md against the specification, checking frontmatter consistency, enforcing naming conventions, and moving misplaced content into the correct references, scripts, or assets directories to streamline maintenance.

Use separate directories for references, scripts, and assets when your agent skill requires progressive disclosure, keeping the main SKILL.md concise while properly placing supporting files to enable scalable and organized skill production.

Progressive disclosure in agent skills separates detailed guidance and resources into subdirectories, keeping the core SKILL.md entry concise while allowing the agent to access deeper references and scripts only when needed.

Yes, you can restructure agent skills by moving content between the main SKILL.md and subdirectories, validating the new structure against the specification to ensure consistent frontmatter and properly placed references.

Building agent skills requires enforcing specific naming conventions for the SKILL.md file and its associated frontmatter, ensuring consistent structure and reliable skill discovery across directories.