SKILL

Asset Audit

From Claude-Code-Game-Studios by @donchitos · View on GitHub

Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline requirements. Identifies orphaned assets, missing references, and standard violations.

This skill ships inside the claude-code-game-studios package. Install the package to get this skill plus everything else in the bundle.

sv install donchitos/claude-code-game-studios

Phase 1: Read Standards

Read the art bible or asset standards from the relevant design docs and the CLAUDE.md naming conventions.


Phase 2: Scan Asset Directories

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

Phase 3: Run Compliance Checks

Naming conventions:

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

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

Orphaned assets: Search code for references to each asset file. Flag any with no references.

Missing assets: Search code for asset references and verify the files exist.


Phase 4: Output Audit Report

markdown
# 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]

## Verdict: [COMPLIANT / WARNINGS / NON-COMPLIANT]

This skill is read-only — it produces a report but does not write files.


Phase 5: Next Steps

  • Fix naming violations using the patterns defined in CLAUDE.md.
  • Delete confirmed orphaned assets after manual review.
  • Run /content-audit to cross-check asset counts against GDD-specified requirements.