# Unity Broken Refs Triage

> Use when prefabs/scenes show Missing Script or pink materials: triage broken script and asset GUID references and decide fix order.

- Skill: `rachitkumarrastogi/unity-broken-refs-triage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rachitkumarrastogi/unity-broken-refs-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rachitkumarrastogi/unity-broken-refs-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rachitkumarrastogi (https://skillmd.com/u/rachitkumarrastogi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rachitkumarrastogi/unity-broken-refs-triage

---

# Broken references triage

## Discovery

1. `get_broken_script_refs` — Missing Script on prefabs/scenes
2. `get_broken_asset_refs` — any missing GUID refs (mats, controllers, …)
3. `find_references` — who still points at a deleted asset GUID/path
4. `get_meta_for_asset` — confirm GUID still exists for survivors

## Fix order

1. Restore or reassign scripts (GUID in `.meta` must match YAML `m_Script`).
2. Fix materials/shaders (`list_materials_using_shader`).
3. Fix Animator/Timeline refs (`list_animator_controllers`, `list_timeline_playables`).
4. Re-run both broken-ref tools until empty.

## Prompts

- *"Which prefabs have missing scripts?"*
- *"List broken asset GUID references"*