# Project Auditor Fixes

Instructions for how to use Project Auditor to find and fix a list of issues.

- Repository: https://github.com/Unity-Technologies/skills (1197 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Unity-Technologies/skills --skill project-auditor-fixes -g -a claude-code -y`
Codex: `npx skills add Unity-Technologies/skills --skill project-auditor-fixes -g -a codex -y`
Cursor: `npx skills add Unity-Technologies/skills --skill project-auditor-fixes -g -a cursor -y`
Gemini CLI: `npx skills add Unity-Technologies/skills --skill project-auditor-fixes -g -a gemini-cli -y`

## Description

Instructions for how to use Project Auditor to find and fix a list of issues.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Using Project Auditor
Project Auditor carries out a static analysis scan of the Unity Project and reports a list of CSV issues that may be fixed.  Trigger, poll, read.

## Prerequisites
To use Project Auditor you'll need the Unity CLI installed - see the unity-cli skill for more details.
Once you have that, the `diagnostics run_audit` and `diagnostics audit_status` commands run Project Auditor checks.

```bash
unity command diagnostics run_audit              # optional: --categories Code,ProjectSetting --output my.csv
unity command diagnostics audit_status           # repeat until a terminal status is returned
```

`diagnostics audit_status` terminal status are `completed` (with `csvPath` + `issueCount`), `failed`, `unavailable`, and
`interrupted` (a domain reload killed the scan, just re-run `diagnostics run_audit`). Polling is responsive while a
scan compiles assemblies and is busy on the main thread. You can only run one scan at a time: a second `diagnostics run_audit`
returns `busy`. There is no cancel, stop polling to abandon a scan.

The output CSV has columns: `Category, Severity, Areas, Description, RelativePath, Line, DescriptorId, Recommendation`
(these are diagnostics only, so every row is something to fix; `Recommendation` says how to do it).

> **Requires Project Auditor plus its rules.** `unavailable` means the Editor has no Project Auditor,
> or it has no analysis rules, in a built-in-module Editor the rules live in the separate
> `com.unity.project-auditor-rules` package (`unity command package add --identifier
> com.unity.project-auditor-rules --confirm true`). Read the `message` field; the command never reports
> an empty `completed` scan that would look like a clean project.

## Gotchas

The rest: https://github.com/Unity-Technologies/skills/blob/HEAD/skills/project-auditor-fixes/SKILL.md