| name | unity-asset-management |
| description | Manage Unity assets and import metadata with unity-cli. Use when the user asks to refresh the asset database, inspect asset info, create or modify a material, create an animation clip or sprite atlas, update import settings, or analyze asset dependencies before moving or deleting files. Do not use for Addressables groups or content builds; use `unity-addressables`. Do not use for scene object edits; use `unity-gameobject-edit`. |
| allowed-tools | Bash(unity-cli:*), Read, Grep, Glob |
| metadata | {"author":"akiojin","version":"0.3.1","category":"assets","triggers":["asset","material","import","animation","sprite","dependency"],"siblings":["unity-addressables","unity-prefab-workflow","unity-gameobject-edit","unity-editor-tools"]} |
Asset Management
Manage the Unity Asset Database, materials, animation clips, sprite atlases, import settings, and asset dependency analysis. This skill is the file/asset complement to unity-addressables (which handles groups and content builds).
Use When
- The user wants to inspect, refresh, move, or otherwise manage project assets.
- The user wants to create or update materials.
- The user wants to author AnimationClip or SpriteAtlas assets.
- The user needs import settings or dependency analysis before file changes.
Do Not Use When
- The task is Addressables groups or content builds; use
unity-addressables.
- The request is about scene-instance edits; use
unity-gameobject-edit.
- The work happens inside prefab edit mode; use
unity-prefab-workflow.
Preferred Flow
- Inspect the target asset with
manage_asset_database using {"action":"get_asset_info","assetPath":"..."} before changing it.
- Run
analyze_asset_dependencies before deleting, moving, or changing shared assets.
- Apply import or material changes with the narrowest possible payload.
- Call
refresh_assets after any out-of-editor file change.
unity-cli raw manage_asset_database --json '{"action":"get_asset_info","assetPath":"Assets/Textures/hero.png"}'
unity-cli raw manage_asset_database --json '{"action":"refresh"}'
unity-cli raw create_material --json '{"materialPath":"Assets/Materials/HeroMat.mat","shader":"Standard"}'
unity-cli raw create_animation_clip --json '{"clipPath":"Assets/Animations/Hero.anim","spritePaths":["Assets/Sprites/Hero/idle_0.png"],"frameRate":12,"loopTime":true}'
unity-cli raw analyze_asset_dependencies --json '{"action":"get_dependencies","assetPath":"Assets/Prefabs/Player.prefab","recursive":true}'
Examples
- "Refresh the asset database and inspect
Assets/Textures/hero.png."
- "Create a material for the player and tint it red."
- "Generate an animation clip from a set of sprite frames."
- "Check which assets depend on
Player.prefab before moving it."
References
