unity-asset-management

Asset & Material Management

Manage the Unity Asset Database, create or modify materials, create animation clips and sprite atlases, and control import settings. Read references/asset-safety.md when the task involves dependency analysis, import changes, or material updates that may affect many assets.

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 specifically about Addressables groups and content builds.
• The request is about scene object or prefab editing rather than asset files.

Recommended Flow

1. Inspect the target asset or material before changing it.
2. Run dependency analysis before deleting, moving, or changing shared assets.
3. Apply import or material changes with the narrowest possible payload.
4. Refresh the Asset Database if files changed outside the editor.

Commands

# Asset database
unity-cli raw manage_asset_database --json '{"action":"refresh"}'
unity-cli raw manage_asset_database --json '{"action":"get_asset_info","assetPath":"Assets/Textures/hero.png"}'
unity-cli raw refresh_assets --json '{}'

# Materials
unity-cli raw create_material --json '{"materialPath":"Assets/Materials/HeroMat.mat","shader":"Standard"}'
unity-cli raw modify_material --json '{"materialPath":"Assets/Materials/HeroMat.mat","properties":{"_Color":{"r":1,"g":0,"b":0,"a":1}}}'

# Animation / Sprite assets
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 create_sprite_atlas --json '{"atlasPath":"Assets/Atlases/UI.spriteatlas","packables":["Assets/Sprites/UI"]}'

# Import settings
unity-cli raw manage_asset_import_settings --json '{"action":"modify","assetPath":"Assets/Textures/hero.png","settings":{"maxTextureSize":1024}}'

# Dependency analysis
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."
• "Create a sprite atlas for a folder of UI sprites."
• "Check which assets depend on Player.prefab before I move it."

Common Issues

• Asset changes made outside Unity are not visible: run refresh_assets.
• Import changes affect more files than expected: inspect the asset first and keep the payload focused.
• Deleting or moving assets is risky: use analyze_asset_dependencies before the mutation.
• Addressables content issues belong in unity-addressables, not this skill.