| name | scaffold-skill |
| description | Scaffold a new skill inside speckit-pro (or another plugin in this marketplace). Creates skills/<name>/SKILL.md with valid YAML frontmatter, optionally mirrors under codex-skills/, then runs python3 tests/speckit-pro/run-all.py --layer 1 to verify. Triggers on "scaffold skill", "add a skill", "new speckit skill", "create skill in plugin". |
| license | MIT |
scaffold-skill
Scaffolds a new skill in a marketplace plugin. Both user-invocable and Claude-invocable.
Inputs to ask for
- Plugin — which plugin (default:
speckit-pro)
- Skill name — kebab-case, e.g.
my-skill
- Description — one sentence with concrete trigger phrases (the description is what Claude matches on; vague descriptions = skill never fires)
- Codex mirror — yes/no. If yes, also create under
codex-skills/<name>/SKILL.md
- References / scripts — does the skill need supporting files? Default: no (start minimal per CLAUDE.md "Simplest change" rule)
What this creates
<plugin>/skills/<name>/
└── SKILL.md
With frontmatter:
---
name: <name>
description: <description>
license: MIT
---
Optional Codex mirror:
<plugin>/codex-skills/<name>/
└── SKILL.md
Optional references/ and scripts/ subdirs (only if user said yes).
Post-create
Always run from the repository root:
python3 tests/speckit-pro/run-all.py --layer 1
If Codex mirror created, also run:
python3 tests/speckit-pro/layer1-structural/validate-codex-skills.py
If either fails, fix the SKILL.md before reporting success.
What this does NOT do
- Does not touch
marketplace.json or release-please-config.json (skills don't have their own version; they live inside a plugin)
- Does not commit (use
plugin-publish skill for that, or commit manually)
- Does not write skill body content — only the frontmatter scaffold. User fills in the body.
Hard rules
- Frontmatter must have at minimum
name and description
name in frontmatter must match the directory name- Description must include concrete trigger phrases — not just "Helps with X"
- Codex mirror must have identical
name to the Claude Code skill
