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

1. Validates the name against the audit script's kebab-case regex.
2. Refuses to overwrite an existing skills/<skill-name>/.
3. Copies templates/SKILL.md into skills/<skill-name>/SKILL.md, substituting {{name}} and {{description}}.
4. Runs python3 scripts/audit_skills.py skills and reports the result.