unity-cleaner

What problem does it solve?

Unity projects often accumulate unused assets, duplicate files, and missing script/asset references that bloat build size, slow iteration, and cause runtime errors. The Unity Cleaner skill provides deterministic checks to identify these issues and guide safe cleanup.

Core Features & Use Cases

• cleaner_find_unused_assets: Find assets not referenced by others, filtered by type and path.
• cleaner_find_duplicates: Find duplicate files by content hash to reclaim space.
• cleaner_find_missing_references: Find components with missing scripts or null references.
• cleaner_delete_assets: Delete assets with safety via dry-run / two-step confirmation.
• cleaner_get_asset_usage: Find which objects reference a specific asset.

Use Case: You notice a spike in scene load times; run cleaner_find_unused_assets to identify and remove unused materials, then use cleaner_find_duplicates to reclaim space.

Quick Start

Run cleaner_find_unused_assets with assetType="Material" to list potentially unused materials, then optionally run cleaner_delete_assets with dryRun to preview deletions, and finally call cleaner_get_asset_usage to audit references before removal.