omcustom:fix-refs

SkillAI & models

Fix broken agent references and symlinks

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the omcustom:fix-refs skill

What this skill tells your AI

The instructions your AI receives, as published by baekenough/oh-my-customcode in .claude/skills/fix-refs/SKILL.md and read by ahel’s review.

Fix broken references, missing symlinks, and other agent dependency issues.

Options

--all, -a        Fix all agents
--dry-run        Show what would be fixed
--verbose, -v    Show detailed actions

Workflow

1. Run mgr-supplier:audit to identify issues

2. Fix issues:
   ├── Missing skill references → Add
   ├── Missing guide references → Add
   ├── Broken paths → Update
   └── Invalid references → Remove

3. Validate fixes
   └── Re-run mgr-supplier:audit

Fixable Issues

IssueAction
Missing skill refAdd to agent .md file
Missing guide refAdd to agent .md file
Broken pathUpdate path in agent .md file
Invalid referenceRemove from agent .md file

Output Format

Dry Run

[mgr-supplier:fix lang-kotlin-expert --dry-run]

Analyzing: lang-kotlin-expert

Issues found:
  1. Missing guide reference: kotlin

Proposed fixes:
  1. Add guide reference to .claude/agents/lang-kotlin-expert.md

No changes made (dry-run mode).
Run without --dry-run to apply fixes.

Fix Mode

[mgr-supplier:fix lang-kotlin-expert]

Fixing: lang-kotlin-expert

[1/2] Adding missing reference...
  Updating: .claude/agents/lang-kotlin-expert.md
  ✓ Guide reference added

[2/2] Validating...
  Running mgr-supplier:audit...
  ✓ All dependencies valid

Summary:
  Fixed: 1 issue
  Status: HEALTHY

Agent lang-kotlin-expert is now healthy.

Fix All

[mgr-supplier:fix --all]

Scanning all agents for issues...

Found issues in 2 agents:
  - lang-kotlin-expert: 1 issue
  - new-agent: 2 issues

Fixing lang-kotlin-expert...
  ✓ Added guide reference: kotlin

Fixing new-agent...
  ✓ Added skill reference: skill-a
  ✓ Added skill reference: skill-b

Validating all agents...
  ✓ mgr-supplier:audit --all passed

Summary:
  Agents fixed: 2
  Issues resolved: 3
  All agents healthy.

Signals

GitHub stars
34
Forks
6
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
omcustom-fix-refs
Source
github.com/baekenough/oh-my-customcode