| name | create-skill |
| description | Add a Copilot-discoverable SKILL.md under .github/skills/<name> and optional scripts/skills/<name>.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//SKILL.md and (optionally) a companion executable helper script under scripts/skills/.sh. Writes a brief report to run/skills/create-skill//.
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"