create-skill

/create-skill Command

Scaffold a new scaffolding-compatible skill: an interactive flow that creates skills/<name>/SKILL.md from the canonical template, composes a TRIGGER/SKIP description, and validates the result.

Usage

/create-skill

Run from the root of the cloned scaffolding plugin repository (the directory containing skills/, commands/, and validators/).

What It Does

1. Locates the plugin root (so the template and validator can be found)
2. Collects skill inputs interactively (name, purpose, triggers, SKIP neighbours)
3. Validates the name is kebab-case and not already taken
4. Scaffolds skills/<name>/SKILL.md from templates/skill-template.md
5. Composes the description frontmatter per the Description Contract
6. Runs validators/validate-skill.sh and reports pass/fail
7. Hands off to tech-writer for README/CHANGELOG and manifest updates

Apply the skill-authoring skill throughout — it owns the frontmatter contract, body structure, and the Description Contract referenced below.

Steps

Follow these steps exactly.

1. Find the plugin root directory

PLUGIN_ROOT=""

find_plugin_root() {
  local base="$1"
  [ -d "$base" ] || return
  local latest
  latest=$(find "$base" -name "CLAUDE.md" -path "*/scaffolding/*/CLAUDE.md" 2>/dev/null | sort -V | tail -1 | xargs dirname 2>/dev/null || true)
  if [ -n "$latest" ] && [ -f "$latest/CLAUDE.md" ]; then echo "$latest"; return; fi
  latest=$(find "$base" -name "CLAUDE.md" 2>/dev/null | sort -V | tail -1 | xargs dirname 2>/dev/null || true)
  if [ -n "$latest" ] && [ -f "$latest/CLAUDE.md" ]; then echo "$latest"; return; fi
}

# If the current directory is itself a plugin checkout, prefer it.
if [ -d "skills" ] && [ -d "validators" ] && [ -f "templates/skill-template.md" ]; then
  PLUGIN_ROOT="$(pwd)"
fi

if [ -z "$PLUGIN_ROOT" ]; then
  for base in \
    "$HOME/.claude/plugins/cache/komluk-scaffolding" \
    "$HOME/.claude/plugins/marketplaces/komluk-scaffolding"; do
    found=$(find_plugin_root "$base")
    if [ -n "$found" ]; then PLUGIN_ROOT="$found"; break; fi
  done
fi

echo "Plugin root: ${PLUGIN_ROOT:-NOT FOUND}"