fix-refs

Identify and fix broken agent references and symlinks via mgr-supplier audits.

34|5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/baekenough/oh-my-customcode --skill fix-refs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-refs
Source: https://github.com/baekenough/oh-my-customcode/tree/main/templates/.claude/skills/fix-refs
Command: npx skills add https://github.com/baekenough/oh-my-customcode --skill fix-refs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fix broken agent references and symlinks that prevent agents from loading or operating correctly.

Core Features & Use Cases

  • Identify missing or broken references across agent definitions and guides.
  • Update paths and symlinks to restore healthy agent dependencies.
  • Validate fixes by re-running audits to ensure healthy agent configurations.

Quick Start

Run mgr-supplier:audit to identify issues, then run mgr-supplier:fix to repair references across agents.

Frequently Asked Questions about fix-refs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix broken agent references and symlinks in my project?

Fixing broken agent references involves identifying missing paths or invalid symlinks through an audit, applying automated corrections to restore dependencies, and validating the results with a final health check across project environments.

What causes broken symlinks and missing references in agent configurations?

Broken symlinks and missing references occur when agent definition files or guides are moved or deleted, invalidating the paths that agents rely on to load and operate correctly in project environments.

What is the best way to audit and repair agent dependencies automatically?

The best way to repair agent dependencies is executing a deterministic workflow that first audits configurations to identify issues, then applies fixes to correct broken paths and symlinks, and finally re-runs an audit to validate overall agent health.

Can I repair invalid references for multiple agents at the same time?

Yes, you can repair invalid references for multiple agents simultaneously by running an automated fix workflow that identifies and updates broken paths and symlinks across all agent definitions in the project environment.

How do I validate agent health after fixing broken paths and symlinks?

You validate agent health after fixing broken paths by re-running an audit workflow, which checks that all previously missing references and broken symlinks have been successfully corrected and agents can load properly.