skills.rest
ethanJPope
ethanJPopeCOMMUNITY
Explore all skills by this author →
GitHub

unity-cleaner

Audit and clean Unity projects by finding unused, duplicate, and oversized assets.

Updated Aug 18, 2026
Search Tags:#game development#unity#duplicate detection#project audit#asset cleanup#missing references#unused assets
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-cleaner-ethanjpope
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-cleaner
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/cleaner
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-cleaner-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects accumulate bloat over time: unused materials, duplicate textures, missing script references, and empty folders inflate build sizes and slow development. This Skill audits a Unity project and safely removes the clutter. ## Core Features & Use Cases - Asset Auditing: Find unused assets, duplicate files by MD5 hash, large assets by size, and empty folders anywhere in the project. - Reference Integrity: Detect missing scripts and null references on GameObjects, inspect asset usage and dependency trees, and fix missing script components in place. - Safe Deletion: Deleting assets uses a two-step confirmToken handshake (preview first, confirm within 5 minutes), and destructive operations are gated by the operating mode. - Use Case: Before a release, run a full audit to find duplicate textures wasting 50 MB, list unused materials, preview the deletion, then confirm to reclaim disk space. ## Quick Start Ask the assistant to find duplicate textures and unused materials in the Unity project, then preview deleting the unused assets before confirming.

Frequently Asked Questions about unity-cleaner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find unused assets in a Unity project?▼

Use cleaner_find_unused_assets with an assetType filter such as Material or Texture2D and an optional searchPath. It returns assets not referenced by others, including path, type, and size, so you can review them before deletion.

How to find duplicate files in Unity by content?▼

Use cleaner_find_duplicates, which groups files by MD5 hash within a chosen asset type and search path. It reports duplicate groups, file lists, and total wasted bytes so you can decide which copies to remove.

How do I safely delete assets in Unity without losing work?▼

cleaner_delete_assets uses a two-step confirmToken handshake: call it with paths to preview what will be deleted, then call again with the returned token within 5 minutes to confirm. Deletion is also blocked in Approval and Auto modes unless explicitly allowed.

Can I fix missing script references on Unity GameObjects?▼

Yes. cleaner_find_missing_references locates missing scripts and null references across the scene, and cleaner_fix_missing_scripts removes the missing script components in place without deleting any assets.

Why does cleaner_delete_assets return MODE_FORBIDDEN?▼

Delete operations carry SkillOperation.Delete and are forbidden in Approval and Auto modes. They only run under Bypass mode or through a user-managed Allowlist entry; the standard grant flow does not unlock them.

Related Skills

Explore More Software Engineering Skills→
FermislothFermisloth
1

assets-find

Search Unity project assets by name, label, type, or folder using filter strings.

Community
Basic
muddyrainmuddyrain
1

unity-cleaner

Scan Unity projects for unused assets, duplicates, and missing references.

Community
Intermediate
dyCuong03dyCuong03

cocos-playable-engineer

Automate Cocos Creator 3.8.x playable scene, prefab, and asset hierarchy construction.

Community
Advanced
du-qwqdu-qwq

unity-scriptableobject

Create, edit, find, and export ScriptableObject assets in Unity projects.

Community
Intermediate