batihandev/unity-mcp-skills/cleaner

Unity Cleaner Skills

Overview

Cleaner skills are read-only analysis except for cleaner_delete_empty_folders and cleaner_fix_missing_scripts. To delete assets, route to the asset module (asset_delete / asset_delete_batch); cleaner_delete_assets returns a preview only.

Common Mistakes

DO NOT (common hallucinations):

• cleaner_delete / cleaner_remove do not exist → use asset_delete / asset_delete_batch to actually remove.
• cleaner_fix does not exist → use cleaner_fix_missing_scripts specifically for missing script references.
• cleaner_scan / cleaner_find_unused do not exist → use specific skills: cleaner_find_unused_assets, cleaner_find_duplicates, cleaner_find_missing_references, cleaner_find_empty_folders, cleaner_find_large_assets.

Routing:

• To delete found assets → asset module's asset_delete / asset_delete_batch.
• For project validation → validation module.

Skills Overview

Skills

cleaner_find_unused_assets

Find potentially unused assets of a specific type.

Returns: {success, assetType, searchPath, potentiallyUnusedCount, note, assets: [{path, name, type, sizeBytes}]}

Recipe: [../../recipes/cleaner/cleaner_find_unused_assets.md](../../recipes/cleaner/cleaner_find_unused_assets.md)

cleaner_find_duplicates

Find duplicate files by MD5 hash.

Returns: {success, assetType, count, wastedBytes, groups: [{count, sizeBytes, wastedBytes, files}]}

Recipe: [../../recipes/cleaner/cleaner_find_duplicates.md](../../recipes/cleaner/cleaner_find_duplicates.md)

cleaner_find_missing_references

Find components with missing scripts or null references.

Returns: {success, issueCount, missingScripts, missingReferences, issues: [{type, gameObject, path, ...}]}

Recipe: [../../recipes/cleaner/cleaner_find_missing_references.md](../../recipes/cleaner/cleaner_find_missing_references.md)

cleaner_delete_assets

Preview a deletion against a list of asset paths. Returns size totals without mutating anything; route to asset_delete / asset_delete_batch to actually remove.

Returns: {success, mode: "preview", previewCount, totalBytes, totalMB, assets: [{path, exists, sizeBytes, sizeMB}]}

Recipe: [../../recipes/cleaner/cleaner_delete_assets.md](../../recipes/cleaner/cleaner_delete_assets.md)

cleaner_get_asset_usage

Find what objects reference a specific asset.

Returns: {success, asset: {path, name, type}, usedByCount, usedBy: [{path, name, type}]}

Recipe: [../../recipes/cleaner/cleaner_get_asset_usage.md](../../recipes/cleaner/cleaner_get_asset_usage.md)

cleaner_find_empty_folders

Find empty folders in the project.

Returns: { success, count, folders }

Recipe: [../../recipes/cleaner/cleaner_find_empty_folders.md](../../recipes/cleaner/cleaner_find_empty_folders.md)

cleaner_find_large_assets

Find largest assets by file size.

Returns: { success, count, assets: [{ path, sizeBytes, sizeMB }] }

Recipe: [../../recipes/cleaner/cleaner_find_large_assets.md](../../recipes/cleaner/cleaner_find_large_assets.md)

cleaner_delete_empty_folders

Delete all empty folders.

Returns: { success, deleted, total }

Recipe: [../../recipes/cleaner/cleaner_delete_empty_folders.md](../../recipes/cleaner/cleaner_delete_empty_folders.md)

cleaner_fix_missing_scripts

Remove missing script components from GameObjects.

Returns: { success, removedComponents }

Recipe: [../../recipes/cleaner/cleaner_fix_missing_scripts.md](../../recipes/cleaner/cleaner_fix_missing_scripts.md)

cleaner_get_dependency_tree

Get dependency tree for an asset.

Returns: { success, assetPath, dependencyCount, dependencies: [{ path, type }] } or { error } if asset not found.

Recipe: [../../recipes/cleaner/cleaner_get_dependency_tree.md](../../recipes/cleaner/cleaner_get_dependency_tree.md)

Example Workflow: Clean Project

1. cleaner_find_unused_assets — identify candidates.
2. cleaner_get_asset_usage — verify each candidate has no active references.
3. cleaner_delete_assets — preview total size + per-asset report.
4. asset_delete_batch — actually delete the vetted set.
5. cleaner_find_empty_folders → cleaner_delete_empty_folders — clean up leftover folders.