95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
---
|
|
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
|
|
# Read-only diagnostic skill — no specialist agent delegation needed
|
|
---
|
|
|
|
## 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.
|