asset-audit

name	asset-audit
description	Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline requirements. Identifies orphaned assets, missing references, and standard violations.
argument-hint	[category|all]
user-invocable	true
allowed-tools	Read, Glob, Grep

When this skill is invoked:

1. Read the art bible or asset standards from the relevant design docs and the STUDIO.md / technical-preferences naming conventions.

2. Scan the target asset directory using Glob:

   • assets/art/**/* for art assets
   • assets/audio/**/* for audio assets
   • assets/vfx/**/* for VFX assets
   • assets/shaders/**/* for shaders
   • assets/data/**/* for data files

3. Check naming conventions:

   • Art: [category]_[name]_[variant]_[size].[ext]
   • Audio: [category]_[context]_[name]_[variant].[ext]
   • All files must be lowercase with underscores

4. Check file standards:

   • Textures: Power-of-two dimensions, correct format (PNG for UI, compressed for 3D), within size budget
   • Audio: Correct sample rate, format (OGG for SFX, OGG/MP3 for music), within duration limits
   • Data: Valid JSON/YAML, schema-compliant

5. Check for orphaned assets by searching code for references to each asset file.

6. Check for missing assets by searching code for asset references and verifying the files exist.

7. Output the audit:

# Asset Audit Report -- [Category] -- [Date]

## Summary
- **Total assets scanned**: [N]
- **Naming violations**: [N]
- **Size violations**: [N]
- **Format violations**: [N]
- **Orphaned assets**: [N]
- **Missing assets**: [N]
- **Overall health**: [CLEAN / MINOR ISSUES / NEEDS ATTENTION]

## Naming Violations
| File | Expected Pattern | Issue |
|------|-----------------|-------|

## Size Violations
| File | Budget | Actual | Overage |
|------|--------|--------|---------|

## Format Violations
| File | Expected Format | Actual Format |
|------|----------------|---------------|

## Orphaned Assets (no code references found)
| File | Last Modified | Size | Recommendation |
|------|-------------|------|---------------|

## Missing Assets (referenced but not found)
| Reference Location | Expected Path |
|-------------------|---------------|

## Recommendations
[Prioritized list of fixes]