skills-auditor-route

name	skills-auditor-route
description	Skills Auditor cycle 3 — Select-One routing per platform; top entry defaults to --apply unless dry-run. Writes JSON traces under ~/.skills-auditor/traces/. Sub-skill of skills-auditor.

Skills Auditor — Route (cycle 3)

When to use

• Duplicate name: with different content (multi-version) inside a bundle (e.g. gstack).
• Scoped: “route Codex”, SKILLS_AUDITOR_MODE=route.

Model

DISCOVERED → CLASSIFIED → ROUTED → RESOLVED

Phases: hash variants → infer platform from path (e.g. .agents/ → codex) → pick one identity → archive/delete/keep the rest.

Strategies

Strategy	Superseded files
archive (default)	SKILL.md.archived-<timestamp>
delete	removed
keep	unchanged (audit-only)

Commands

skills-audit route --platform cursor --skills-dir "$HOME/.cursor/skills" --strategy archive

skills-audit route --platform codex --skills-dir "$HOME/.claude/skills" --strategy archive

skills-audit route \
  --platform cursor \
  --skills-dir "$HOME/.cursor/skills" \
  --strategy archive \
  --apply

skills-audit route \
  --platform codex \
  --skills-dir "$HOME/.claude/skills" \
  --trace-dir ./my-traces

Ledger behavior

• Mode: dry-run writes route trace JSON but does not change skill files; --apply may archive, delete, or keep superseded variants based on --strategy.
• Record the route cycle as a skill-run row. While work is open use status=active; after trace audit and any apply step, move it to completed, handoff, blocked, or failed.
• Record the emitted state-machine trace as a trace row with status=preserved and locator set to the trace file path.
• Applied archives/deletes should be recorded as artifact or external-resource rows with locators for the affected SKILL.md or archived path. Do not remove the route trace when cleaning up; the ledger points to it.
• If routing cannot choose one active variant, mark the relevant row blocked with --blocked-reason or handoff with --handoff-target.

Parent

../../SKILL.md · Next: ../traces/SKILL.md.