new-skill
Creates a new skill at skills/<name>/ with a valid SKILL.md (correct frontmatter, kebab-case name, semver version) so it passes python3 scripts/audit_skills.py skills immediately.
Usage
bash "$CLAUDE_PROJECT_DIR/.claude/skills/new-skill/scripts/scaffold.sh" <skill-name> "<one-line description>"
<skill-name> must be kebab-case (lowercase letters, digits, hyphens — no underscores, no dots).
What it does
- Validates the name against the audit script's kebab-case regex.
- Refuses to overwrite an existing
skills/<skill-name>/. - Copies
templates/SKILL.mdintoskills/<skill-name>/SKILL.md, substituting{{name}}and{{description}}. - Runs
python3 scripts/audit_skills.py skillsand reports the result.
After scaffolding
- Flesh out the SKILL.md body (Workflow, references, examples).
- Add
references/,templates/,scripts/,examples/directories only if the skill needs them. - Bump the
versionin frontmatter when you make changes (see CLAUDE.md → Versioning). - The
package-skill.shPostToolUse hook will rebuilddist/<skill-name>.skillautomatically on the first edit.