Scaffold skill

Skill racecraft-lab/racecraft-plugins-public/.claude/skills/scaffold-skill

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".From its SKILL.md

Install

npx -y skills add racecraft-lab/racecraft-plugins-public --skill scaffold-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.2 KB, as published. Nobody here has run it

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