skills.rest
du-qwq
du-qwqCOMMUNITY
Explore all skills by this author →
GitHub

unity-yaml-editing

Repairs Unity serialized YAML files by fixing GUIDs, fileID references, and merge conflicts.

Updated Jun 21, 2026
Search Tags:#unity#yaml#merge conflict#serialization#prefab#guid#fileid
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-yaml-editing-du-qwq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-yaml-editing
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/yaml-editing
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-yaml-editing-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When Unity scenes, prefabs, or assets break in ways the Editor and REST APIs cannot fix — such as missing scripts after a rename, corrupted .meta GUIDs, hidden ProjectSettings fields, or Git merge conflicts in .unity files — the only remaining option is hand-editing the serialized YAML, which is risky without strict rules. ## Core Features & Use Cases - Reference and fileID Repair: Fix broken m_Script GUID references and safely delete Missing components by removing both the object block and its m_Component entry. - .meta and GUID Safety: Detect pseudo-random GUIDs, regenerate them with uuid4, and update every referencing file in the same change. - ProjectSettings Patching and Merge Resolution: Edit hidden ProjectSettings YAML fields and resolve .unity/.prefab merge conflicts block-by-block without dropping objects. - Use Case: A renamed C# script leaves a prefab showing "missing script" and the scene won't open. Read the script's current GUID from its .cs.meta, update the prefab's m_Script guid field, then reimport to validate the fix. ## Quick Start Fix the missing script reference in my prefab by updating its m_Script GUID to match the renamed script's .meta file.

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 a missing script reference in a Unity prefab?▼

Read the script's current GUID from its .cs.meta file, then find the m_Script entry in the prefab YAML and set its guid field to that value while keeping fileID 11500000 and type 3. Reimport the asset in Unity to confirm the reference resolves.

How to resolve merge conflicts in Unity scene files?▼

Unity YAML is line-mergeable because each object is an independent block headed by --- !u!<classID> &<fileID>. Resolve per block, taking the changed side for single-side edits and doing a true 3-way merge for blocks changed on both sides, then verify every referenced fileID still has a defining block.

When should I hand-edit Unity YAML instead of using the Editor?▼

Only as a last resort: when a compile failure prevents deserialization, when editing .meta files or hidden ProjectSettings fields with no API, or when resolving merge conflicts. For normal object, prefab, or scene work, use the Editor or REST APIs since they keep serialization valid.

Why does changing a Unity GUID break asset references?▼

A GUID is the asset-level identity referenced by every .unity, .prefab, .asset, and .meta file that points to it. Changing the GUID without updating all referencing files orphans those references, so you must grep the whole project and update every occurrence in the same change.

How do I safely delete a missing component from a Unity scene file?▼

Remove the entire MonoBehaviour block (--- !u!114 &<fileID>) and also delete the matching component entry under the owner GameObject's m_Component list. Removing only one of the two corrupts the file and breaks the GameObject.

Related Skills

Explore More Software Engineering Skills→
Darth-CarrotpieDarth-Carrotpie

unity-yaml-editing

Repairs Unity serialized YAML files by fixing GUIDs, fileID references, and merge conflicts.

Community
Intermediate
IgorGribowskyIgorGribowsky

unity-asset-safety

Prevents silent Unity asset data loss when editing prefabs, scenes, and serialized fields.

Community
Intermediate
yuse168yuse168

unity-yaml-editing

Repairs Unity serialized YAML files by fixing GUIDs, fileID references, and merge conflicts.

Community
Advanced
woocommercewoocommerce
10.5k

woocommerce-backend-dev

Guide WooCommerce backend PHP code implementation according to project conventions.

Official
Advanced