unity-yaml-editing

Repair broken Unity serialized YAML files while preserving anchors and references.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Rayzerrek/dotfiles --skill unity-yaml-editing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-yaml-editing
Source: https://github.com/Rayzerrek/dotfiles/tree/main/.pi/agent/skills/unity-skills/skills/yaml-editing
Command: npx skills add https://github.com/Rayzerrek/dotfiles --skill unity-yaml-editing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you safely repair Unity serialized YAML when the Editor or REST tooling cannot deserialize the file, such as after compile failures, broken references, missing scripts, or merge conflicts.

Core Features & Use Cases

  • Reference and fileID repair: Fix broken m_Script GUIDs, restore missing MonoBehaviour links, and remove missing components without corrupting the owner object.
  • GUID and .meta safety: Update GUIDs carefully, keep every reference in sync, and avoid accidental collisions when a script or asset identifier changes.
  • ProjectSettings and merge conflict handling: Patch hidden ProjectSettings fields and resolve per-block Unity YAML merge conflicts while preserving anchors and references.

Quick Start

Use the unity-yaml-editing skill to safely hand-edit the broken Unity YAML file and repair its references, GUIDs, or merge conflicts without changing unrelated structure.

Frequently Asked Questions about unity-yaml-editing

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

FAQPage Schema
How do I fix broken Unity YAML files when the Editor cannot deserialize them?

Fix broken Unity YAML files by hand-editing the serialized data to repair missing scripts, broken references, and GUID changes, ensuring anchors and fileID integrity are preserved for successful reimport.

What is the best way to resolve Unity merge conflicts in .prefab and .unity files?

Resolve Unity YAML merge conflicts by patching per-block conflicts while preserving anchors and references, ensuring structure remains uncorrupted and allowing the Editor to successfully deserialize the file.

How do I safely replace a missing script GUID in Unity serialized files?

Safely replace a missing script GUID by updating the identifier and keeping every reference in sync, avoiding accidental collisions while maintaining complete fileID integrity across the asset.

Can I hand-edit Unity ProjectSettings files to patch hidden fields?

Yes, you can hand-edit Unity ProjectSettings files to patch hidden fields by repairing the serialized YAML text directly, preserving all anchors and references during the edit.

Does hand-editing Unity YAML preserve MonoBehaviour links and fileID integrity?

Yes, hand-editing Unity YAML preserves MonoBehaviour links and fileID integrity by carefully repairing broken references and removing missing components without corrupting the owner object.

What are the limitations of manually repairing Unity YAML serialization errors?

Manual Unity YAML repair requires safe preservation of anchors and references, complete reference updates after GUID replacement, and post-edit reimport validation to ensure the Editor parses the file correctly.