skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills88 installs

unity-cleaner

Clean up and audit a Unity project

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-cleaner
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The unity-cleaner skill provides tools for managing Unity project assets, including finding unused, duplicate, or large files. It incorporates safety mechanisms such as two-step confirmation for deletions and operates locally. No security threats were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Unity Cleaner Skills

Find and clean up project bloat: unused, duplicate, missing-reference and empty assets, large assets, asset usage and dependency trees. The module reports and does not delete, except through the two-step cleaner_delete_assets and cleaner_delete_empty_folders. Parameters come from the schema (GET /skills/schema?category=Cleaner&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Reducing project bloat
  • Hunting duplicate or orphaned assets
  • Auditing before a release

Rules

  • cleaner_delete_assets takes two calls. Call it without confirmToken to preview; call it again with the returned confirmToken to delete. The token expires after 5 minutes. There is no dryRun parameter.
  • Analyze and query skills (cleaner_find_*, cleaner_get_asset_usage, cleaner_get_dependency_tree) are read-only and run under Approval.
  • cleaner_delete_assets and cleaner_delete_empty_folders are delete-class: under Approval and Auto they return MODE_FORBIDDEN, and only Bypass or an Allowlist entry runs them. A grant does not unlock them.
  • cleaner_fix_missing_scripts replaces missing script components in place and deletes no asset. It is not delete-class, so under Approval it needs the standard grant.
  • To remove assets that the analysis finds without the two-step path, use asset asset_delete. Project validation belongs to the validation module.

Pitfalls

  • cleaner_delete and cleaner_remove do not exist: the cleaner skills find and report; use the two-step cleaner_delete_assets or asset_delete.
  • cleaner_fix does not exist: use cleaner_fix_missing_scripts for missing script references.
  • cleaner_scan and cleaner_find_unused do not exist: use the specific cleaner_find_* skills.

Skills Overview

SkillDescription
cleaner_find_unused_assetsFind assets not referenced by others
cleaner_find_duplicatesFind duplicate files by content hash
cleaner_find_missing_referencesFind missing scripts/asset references
cleaner_delete_assetsDelete assets via two-step confirmToken (preview → confirm)
cleaner_get_asset_usageFind what references a specific asset
cleaner_find_empty_foldersFind empty folders in the project
cleaner_find_large_assetsFind largest assets by file size
cleaner_delete_empty_foldersDelete all empty folders
cleaner_fix_missing_scriptsRemove missing script components from GameObjects
cleaner_get_dependency_treeGet dependency tree for an asset

Skills

cleaner_find_unused_assets

Find potentially unused assets of a specific type.

ParameterTypeRequiredDefaultDescription
assetTypestringNo"Material"Asset type filter
searchPathstringNo"Assets"Search path
limitintNo100Max results

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

curl -s "http://localhost:<port>/skill/cleaner_find_unused_assets?expectProject=<project>" -d '{"assetType":"Material"}'

Unused textures in one folder:

curl -s "http://localhost:<port>/skill/cleaner_find_unused_assets?expectProject=<project>" -d '{"assetType":"Texture2D","searchPath":"Assets/Textures"}'

cleaner_find_duplicates

Find duplicate files by MD5 hash.

ParameterTypeRequiredDefaultDescription
assetTypestringNo"Texture2D"Asset type
searchPathstringNo"Assets"Search path
limitintNo50Max groups

Returns: {success, duplicateGroupCount, totalWastedBytes, totalWastedMB, groups: [{count, sizeBytes, wastedBytes, files}], skipped: [{path, reason}]} — skipped lists files that could not be read for hashing, so they are not silently missing from the groups.

curl -s "http://localhost:<port>/skill/cleaner_find_duplicates?expectProject=<project>" -d '{"assetType":"Texture2D"}'

cleaner_find_missing_references

Find components with missing scripts or null references.

ParameterTypeRequiredDefaultDescription
includeInactiveboolNotrueInclude inactive objects

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

curl -s "http://localhost:<port>/skill/cleaner_find_missing_references?expectProject=<project>" -d '{}'

cleaner_delete_assets

Delete specified assets with two-step confirmation.

Both steps use this table. Step 1 sends paths; step 2 sends only confirmToken.

ParameterTypeRequiredDescription
pathsstring[]Step 1Asset paths to preview; step 2 deletes exactly the paths captured by the token
confirmTokenstringStep 2Token from the preview; valid 5 minutes

Returns on preview (step 1): {success, action: "preview", totalAssets, existingAssets, totalBytes, totalMB, confirmToken, message, expiresIn, assetsToDelete: [{path, exists, sizeBytes, sizeMB}]}

Returns on confirm (step 2): {success, action: "deleted", deletedCount, totalMB, message, results: [{path, deleted}]}

Step 1, preview (no confirmToken):

curl -s "http://localhost:<port>/skill/cleaner_delete_assets?expectProject=<project>" -d '{"paths":["Assets/Unused/mat1.mat","Assets/Unused/mat2.mat"]}'

Step 2, confirm with the token from step 1 (valid 5 minutes):

curl -s "http://localhost:<port>/skill/cleaner_delete_assets?expectProject=<project>" -d '{"confirmToken":"<token from preview>"}'

cleaner_get_asset_usage

Find what objects reference a specific asset.

ParameterTypeRequiredDescription
assetPathstringYesAsset path
limitintNoMax results (default 50)

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

curl -s "http://localhost:<port>/skill/cleaner_get_asset_usage?expectProject=<project>" -d '{"assetPath":"Assets/Textures/player.png"}'

cleaner_find_empty_folders

Find empty folders in the project.

ParameterTypeRequiredDefaultDescription
searchPathstringNo"Assets"Search path

Returns: { success, count, folders }

curl -s "http://localhost:<port>/skill/cleaner_find_empty_folders?expectProject=<project>" -d '{}'

cleaner_find_large_assets

Find largest assets by file size.

ParameterTypeRequiredDefaultDescription
searchPathstringNo"Assets"Search path
limitintNo20Max results
minSizeByteslongNo0Minimum file size in bytes

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

curl -s "http://localhost:<port>/skill/cleaner_find_large_assets?expectProject=<project>" -d '{"limit":10,"minSizeBytes":1048576}'

cleaner_delete_empty_folders

Delete all empty folders.

ParameterTypeRequiredDefaultDescription
searchPathstringNo"Assets"Search path

Returns: { success, deleted, total }

curl -s "http://localhost:<port>/skill/cleaner_delete_empty_folders?expectProject=<project>" -d '{}'

cleaner_fix_missing_scripts

Remove missing script components from GameObjects.

ParameterTypeRequiredDefaultDescription
includeInactiveboolNotrueInclude inactive objects

Returns: { success, removedComponents }

curl -s "http://localhost:<port>/skill/cleaner_fix_missing_scripts?expectProject=<project>" -d '{}'

cleaner_get_dependency_tree

Get dependency tree for an asset.

ParameterTypeRequiredDefaultDescription
assetPathstringYes-Asset path
recursiveboolNotrueRecursively resolve dependencies

Returns: { success, assetPath, dependencyCount, dependencies: [{ path, type }] }

curl -s "http://localhost:<port>/skill/cleaner_get_dependency_tree?expectProject=<project>" -d '{"assetPath":"Assets/Prefabs/Player.prefab"}'

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-cleaner">View unity-cleaner on skillZs</a>