| name | skill-rename-propagation |
| description | One-pass rename of a skill: folder, frontmatter name, Cursor rules, validators, README catalog, pack scripts, workflows, and consuming-repo references. Use when renaming skills (e.g. looper → control-graph) or after folder moves. Triggers: skill rename, rename propagation, rename skill, looper rename. |
skill-rename-propagation
Load rule: Formal checklist is SoT. Aligns with QUALITY.md rename policy.
// Inputs
OLD, NEW // kebab-case skill names
LIB // skills library root
PROJECTS // optional consuming checkouts
// Axioms
A1 One pass: grep → rewrite → validate → commit (no half-rename)
A2 Keep discovery alias in description for ≥1 release if OLD was public
A3 Update validators that hardcode name === OLD
A4 Symlinks ~/.cursor/skills/OLD and rules/OLD.mdc must be repointed
A5 Archive may keep OLD paths as history — do not "fix" archive unless intentional
A6 Evaluate(δ) ≔ (C, E, η)
Related: dual-copy-skill-publish · author-workflow-skill · master-planner.
Use / skip
| Use | Skip |
|---|
| renaming skill folder/public name | cosmetic title-only in body |
after git mv left broken links | pure content edit without name change |
| pack/README still point at OLD | |
One-pass checklist
[ ] 1. git mv LIB/OLD LIB/NEW (+ rules/OLD.mdc → rules/NEW.mdc if any)
[ ] 2. Frontmatter name: NEW
[ ] 3. Body titles, links, script paths
[ ] 4. Optional redirect OLD/SKILL.md → NEW (legacy discovery) + description alias
[ ] 5. README catalog + QUALITY + pack scripts (master-planner pull-skills.sh)
[ ] 6. Workflows .md/.rhai skill_chain strings
[ ] 7. Consuming projects: AGENTS.md, .agents/skills symlinks
[ ] 8. Run skill validator if present
[ ] 9. rg OLD across LIB — residual only intentional aliases / archive / redirect
[ ] 10. Commit with clear rename message (push=HITL)
Commands
OLD=looper NEW=control-graph
LIB="${SKILLS_ROOT:-$HOME/Work/personal/skills}"
cd "$LIB"
rg -n --glob '!**/.git/**' --glob '!archive/**' "\\b${OLD}\\b" || true
node "$NEW/scripts/validate-skill.mjs" 2>/dev/null || true
rg -n --glob '!**/.git/**' --glob '!archive/**' --glob "!**/${OLD}/**" "\\b${OLD}\\b" || true
Consuming repo
ln -sfn "$LIB/$NEW" .agents/skills/$NEW
rm -f .agents/skills/$OLD
Done when
Anti-patterns
| ¬ | Do |
|---|
| rename folder only | break frontmatter + rules + packs |
| leave pack scripts on OLD | agents pull missing skill |
| delete OLD triggers immediately | keep alias in description/redirect ≥1 release |
| mass-edit archive distill history | leave archive; note supersession |
Done_when cmds: rg -n '^name:' "$NEW/SKILL.md" · rg -n "\\b$OLD\\b" --glob '!archive/**' --glob "!$OLD/**" · validator exit 0.
