skill-creator

To create and structure Agent Skills packages, draft a kebab-case directory under plugins/skill-creator/skills/ and use the Skill Creator to bootstrap a minimal SKILL.md frontmatter. This scaffolding enforces progressive disclosure and routes heavy details to references.

Bootstrapping a SKILL.md file with frontmatter requires generating a minimal spec-aligned header containing name and description. The Skill Creator automates this step to ensure the package is discoverable and auditable.

Progressive disclosure in skill creation is the practice of keeping the SKILL.md file concise while moving heavy details into focused references. This structure reduces ambiguity and integration risk by routing complex logic to separate files.

You validate an Agent Skill package locally by running the built-in validation scaffolding provided by the Skill Creator. This process performs local checks and optional skills-ref validation to ensure the finished skill meets structural requirements.

Scaffolding eval files is an optional but recommended step when creating a new skill. The Skill Creator generates these files to support output-quality and trigger-quality testing for your package.

You should move skill details into references instead of SKILL.md when the content is too heavy for the main file. This approach enforces progressive disclosure, keeping the primary trigger description concise and effective.