migrate-birp-to-urp
An agent skill by Unity-Technologies, from Unity-Technologies/unity-agent-plugin. Tags: debugging, graphics, migration, optimization, rendering.
What it does
Plans, executes, and troubleshoots Unity projects moving from the Built-in Render Pipeline (BiRP/BIRP/Built-in RP) to the Universal Render Pipeline (URP). Use when the user asks to upgrade, convert, switch, or migrate a project, scene, material, or shader to URP/Universal Render Pipeline; fix pink or magenta materials after URP; convert Built-in materials/shaders; move a 2D project to URP 2D; review lighting, quality, post-processing, baked lightmaps, or reflection probes after URP; or diagnose visual problems after a render-pipeline migration.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add Unity-Technologies/unity-agent-plugin --skill migrate-birp-to-urp
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/Unity-Technologies/unity-agent-plugin
cp -r unity-agent-plugin/skills/migrate-birp-to-urp ~/.claude/skills/migrate-birp-to-urp
Safety box score
Grade C, moderate risk: 42 of 100 risk points, rated 2026-10-02. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill drives a live Unity Editor through C# eval to migrate Built-in projects to URP, including package installation, asset conversion, Graphics/Quality assignment, lighting/probe work, and scene edits. The main risks are broad project mutation, one-way conversion steps, and automatic continuation after rollback is confirmed.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 3 (high) | It explicitly runs code in the user's Editor via `unity command eval` and may save helper scripts under `Assets/Editor/`, which is direct code execution in the project context. |
| Network access | 2 (moderate) | It can install URP through Unity's package system (`Ensure URP is installed` / package refresh), which reaches out to package sources, though it does not fetch arbitrary remote code. |
| Filesystem reach | 2 (moderate) | It edits project files and settings broadly — Graphics/Quality settings, materials, scenes, Volume profiles, lighting assets, and possible cleanup of legacy assets — but stays within the Unity project rather than system paths. |
| Secrets & credentials | 0 (none) | The skill does not ask for or access tokens, keys, passwords, browser sessions, keychains, or `.env` files. |
| Privilege & persistence | 0 (none) | There is no sudo, service registration, shell startup modification, or global system installation requirement. |
| Instruction hijack surface | 2 (moderate) | It instructs the agent to continue without further confirmation after rollback safety is confirmed and to follow mandatory reference-loading rules, which is strong agent-directive text even though it is scoped to migration flow. |
| Irreversible actions | 2 (moderate) | The workflow can automatically convert materials, assign URP assets, disable legacy PPv2 during validation, and rebake lighting; these are substantial project-changing actions, but they are intended to occur after user-confirmed rollback safety. |
| Transparency | 0 (none) | The skill files are plain markdown with readable snippets and references; there are no binaries, base64 blobs, or uninspectable installers. |
Before installing
- Clone the project or create a rollback branch before letting it run.
- Check whether the target Unity Editor is 6000.3+ if the project needs `com.unity.pipeline`.
- Open the representative scene and confirm `Packages/manifest.json` already has or will accept URP changes.
- Run the first pass in a disposable copy if you want the migration to proceed past setup automatically.
Rated 2026-10-02 by an automated review of 8 files from the skill's repository.
Source
- Repository
- Unity-Technologies/unity-agent-plugin (all skills from this repository)
- Path
- skills/migrate-birp-to-urp/SKILL.md
- Branch
- main
- Updated
- 2026-09-22
Related skills
- urp-postprocessing — Sets up, configures, and debugs URP post-processing effects using the Volume framework.
- sega-32x-gamedev — Create, improve, optimize, and port games for the Sega 32X (Sega Mars) using Chilly Willy's 32XDK toolchain and the DOOM 32X Resurrection (d32xr) codebase as.
- sega-genesis-sgdk — Create, debug, optimize, and port games for the Sega Genesis / Mega Drive in C using SGDK (the Sega Genesis Development Kit).
- 2d-pixel-perfect — Sets up, diagnoses, and fixes pixel perfect 2D rendering in Unity projects. Use when working on any retro-style or pixel art 2D game.
- sega-master-system-devkitsms — Program, build, debug, and port Sega Master System (and Game Gear / SG-1000) homebrew games in C with devkitSMS (SMSlib + PSGlib) and the SDCC Z80 compiler.
- sql-pro — Optimizes SQL queries, designs database schemas, and troubleshoots performance issues.