create-skill

Provide a description of the skill and its trigger conditions, and the agent drafts a SKILL.md from the bundled template with the required frontmatter, Parameters, Success criteria, Instructions, and Rules sections. It then runs the bundled validator and fixes any reported failures.

The frontmatter must declare name, description, license, and compatibility. The description follows a two-sentence pattern stating what the skill does and when to use it, while compatibility lists the agent tools the instructions actually call for.

Run the bundled create-skill-validate.sh script against the skill directory. It wraps skills-ref validate for canonical checks when installed, and adds repo-specific checks for section order, line length, namespacing, and README structure.

Yes. The agent reads the current SKILL.md first, then rewrites rather than patches it, preserving the name field unchanged. The improved skill must still pass the same validator before the task is complete.

When skills compile to flat instruction files for Copilot or Cursor, every skill's assets, references, and scripts merge into one shared directory. Files without a skill-name prefix can silently overwrite each other across skills.