What problem does it solve?
Keeps a skill library consistent by finding and repairing stale or missing cross-references between SKILL.md files after skills are created, renamed, removed, or restructured, preventing broken invocations and inaccurate Called by contexts.
Core Features & Use Cases
- Registry construction: Scans every .agents/skills/*/SKILL.md and builds an in-memory registry of names, Calls, and Called by relationships.
- Detection and minimal fixes: Identifies stale references from renames/removals, missing references for new skills, and rewiring changes, then performs minimal edits limited to cross-reference strings.
- Validation and safety: Runs validate-skills on every edited file and rolls back edits that drop below the validation threshold, reporting files that require manual review.
- Reporting: Produces an impact report summarizing trigger, scanned skills, fixes made, and validation outcomes.
- Use Case: After renaming agent-architect to agent-builder, run this Skill to update all SKILL.md mentions, fix Called by contexts, and validate the edits.
Quick Start
Run the cross-link-skills repair after renaming a skill to update all SKILL.md cross-references and validate edits.
