asset-audit

Agent Skills › Donchitos/Claude-Code-Game-Studios › asset-audit

asset-audit

GitHub

审计游戏资产合规性，检查命名、大小、格式标准及引用完整性。扫描指定目录并生成详细报告，识别孤立或缺失资产，确保资源符合流水线要求。

.claude/skills/asset-audit/SKILL.md Donchitos/Claude-Code-Game-Studios

Trigger Scenarios

需要检查游戏资源文件是否符合命名和格式规范查找代码中未引用的孤立资产或丢失的引用发布前进行资源合规性审查

Install

npx skills add Donchitos/Claude-Code-Game-Studios --skill asset-audit -g -y

More Options

Non-standard path

npx skills add https://github.com/Donchitos/Claude-Code-Game-Studios/tree/main/.claude/skills/asset-audit -g -y

Use without installing

npx skills use Donchitos/Claude-Code-Game-Studios@asset-audit

指定 Agent (Claude Code)

npx skills add Donchitos/Claude-Code-Game-Studios --skill asset-audit -a claude-code -g -y

安装 repo 全部 skill

npx skills add Donchitos/Claude-Code-Game-Studios --all -g -y

预览 repo 内 skill

npx skills add Donchitos/Claude-Code-Game-Studios --list

SKILL.md

Frontmatter

{
    "name": "asset-audit",
    "model": "sonnet",
    "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.",
    "allowed-tools": "Read, Glob, Grep",
    "argument-hint": "[category|all]",
    "user-invocable": true
}

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

# 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.