# Omcustomfix Refs

> Fix broken agent references and symlinks Use when this capability is needed.

- Skill: `tomevault-io/omcustomfix-refs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/omcustomfix-refs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/omcustomfix-refs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/omcustomfix-refs

---


# Fix References Skill

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

| Issue | Action |
|-------|--------|
| Missing skill ref | Add to agent .md file |
| Missing guide ref | Add to agent .md file |
| Broken path | Update path in agent .md file |
| Invalid reference | Remove 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.
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/baekenough) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-12 -->