name: create-skill
description: "Add a Copilot-discoverable SKILL.md under .github/skills/ and optional scripts/skills/.sh scaffold, emitting a run/skills/create-skill report."
SKILL: create-skill
Summary
Programmatic skill creation utility that adds a SKILL.md under .github/skills/
When to run
- When adding a new SKILL to the repository or provisioning companion scripts.
Inputs
- name (string, required) — kebab-case name for the new SKILL
- description (string, optional) — short description to populate SKILL.md
- create_script (bool, default: true) — whether to create a companion scripts/skills/
.sh
Outputs
- run/skills/create-skill/
/report.txt - run/skills/create-skill/
/report.json - .github/skills/
/SKILL.md (when created) - scripts/skills/
.sh (when requested)
Collection steps
- Validate and sanitize provided name.
- Create .github/skills/
/SKILL.md if not present. - Create scripts/skills/
.sh placeholder if requested. - Write a JSON report to run/skills/create-skill/
/.
Quality rules
- Do not overwrite existing SKILL.md or companion scripts; script writes a report and exits if files exist.
Implementation notes
- Helper script: scripts/skills/create-skill.sh
- Example: sh scripts/skills/create-skill.sh --name new-skill --desc "Short description"