cross-link-skills

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.