project-auditor-fixes — Claude Code skill
project-auditor-fixes — a skill that drives Project Auditor through the Unity CLI and works through the issue list in reviewable batches. Use it when a pile of diagnostics needs clearing without breaking the build.
no license 3,200 installs ★ 1,306 updated 2026-10-30
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a claude-codeWhat project-auditor-fixes does
The skill lays out a workflow around Project Auditor, a static analyser for Unity projects. The scan returns a CSV with columns like Category, Severity, Areas, Description, RelativePath, Line, DescriptorId, and Recommendation. Every row is a real issue to address, and the recommendation field tells you how.
Kick off a scan with unity command diagnostics run_audit, then poll unity command diagnostics audit_status until you get a terminal state: completed with csvPath and issueCount, failed, unavailable, or interrupted. Only one scan runs at a time; a second run_audit comes back as busy. If a domain reload kills the scan, just run it again.
An unavailable status means the editor lacks Project Auditor or its rules. In a built-in-module editor the rules ship separately in com.unity.project-auditor-rules, and without them the command never fakes an empty completed scan that would look like a clean project. Call editor set_auto_tick first: otherwise recompiles and tests can hang while the editor sits unfocused.
The skill recommends running a test case before and after changes — a scene to open in play mode, or a platform build to run. If none exists and nothing is documented, propose one and get confirmation from the user. Commit step by step, in chunks a person can read. Settings issues default to fixing by type across assets; code issues go by file and subfolder. After each batch the code should still compile.
What it helps with
- run a static analysis scan of a Unity project via Unity CLI
- group CSV issues by file and type
- fix asset settings in batches by type
- patch code by file and subfolder, keeping the project compiling between commits
- verify the project with a test case before and after edits
Example prompts for the agent
- Run the audit through Unity CLI and show me the issue list
- Group the CSV issues by file and type
- Fix texture settings according to the audit recommendations
How to install project-auditor-fixes
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a claude-code2Manually: put the files in place
~/.claude/skills/project-auditor-fixes/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/project-auditor-fixes/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a codex2Manually: put the files in place
.agents/skills/project-auditor-fixes/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a cursor2Manually: put the files in place
.cursor/skills/project-auditor-fixes/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Unity-Technologies/skills skills/project-auditor-fixes2Manually: put the files in place
.github/skills/project-auditor-fixes/SKILL.md1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a gemini-cli2Platform CLI
gemini skills install https://github.com/Unity-Technologies/skills --path skills/project-auditor-fixesManually: put the files in place
.devin/skills/project-auditor-fixes/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about project-auditor-fixes
How do I install project-auditor-fixes in Claude Code?
Run npx skills add Unity-Technologies/skills --skill project-auditor-fixes -a claude-code. The skill lands in ~/.claude/skills/project-auditor-fixes/SKILL.md.
What does project-auditor-fixes do?
It describes how to run Project Auditor through the Unity CLI, read the CSV of issues, and fix them in batches by file or type. The recipe includes a test case and step-by-step commits.
Why does the audit return an unavailable status?
The editor has no Project Auditor or no analysis rules. With a built-in-module editor, add com.unity.project-auditor-rules via unity command package add --identifier com.unity.project-auditor-rules --confirm true.