batihandev/unity-mcp-skills/asset

Unity Asset Skills

When to Use

Use this module to import external files into the project, move or rename assets, delete assets, search for assets, create folders, or refresh the AssetDatabase. For import settings (texture compression, audio load type, model scale) use the importer module instead.

BATCH-FIRST: Use *_batch skills when operating on 2+ assets.

Quick Reference

No batch needed: asset_duplicate, asset_find, asset_create_folder, asset_refresh, asset_get_info, asset_reimport, asset_reimport_batch, asset_set_labels, asset_get_labels

For asset search, use the native Unity_FindProjectAssets tool. For multi-filter-group searches in a single task, call it once per filter group — the tool takes a single query string plus startIndex pagination, not a batched filter array.

Common Mistakes

DO NOT (common hallucinations):

• asset_create does not exist → use asset_create_folder (folders), material_create (materials), script_create (scripts)
• asset_rename does not exist → use asset_move with new path
• asset_search does not exist → use asset_find with searchFilter syntax (e.g. t:Texture2D player)
• asset_copy does not exist → use asset_duplicate

Routing:

• For texture/model/audio import settings → use importer module
• For material creation → use material module
• For script creation → use script module

Skills

asset_import

Import an external file into the project.

asset_import_batch

Import multiple external files.

items currently expects a JSON string, not a native array.

Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}

asset_delete

Delete an asset from the project.

asset_delete_batch

Delete multiple assets.

items currently expects a JSON string, not a native array.

Returns: {success, totalItems, successCount, failCount, results: [{success, path}]}

asset_move

Move or rename an asset.

asset_move_batch

Move multiple assets.

items currently expects a JSON string, not a native array.

Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}

asset_duplicate

Duplicate an asset.

asset_find

Find assets by search filter.

Search Filter Syntax:

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

asset_create_folder

Create a folder in the project.

asset_refresh

Refresh the AssetDatabase after external changes.

No parameters.

asset_get_info

Get information about an asset.

asset_reimport

Force reimport of an asset.

asset_reimport_batch

Reimport multiple assets matching a pattern.

asset_set_labels

Set labels on an asset (overwrites existing labels).

Returns: {success, assetPath, labels: [...]}

asset_get_labels

Get the labels currently attached to an asset.

Returns: {success, assetPath, labels: [...]}

Recipe path rule: ../../recipes/asset/<command>.md

Best Practices

1. Organize assets in logical folders
2. Use consistent naming conventions
3. Refresh after external file changes
4. Use search filters for efficiency
5. Backup before bulk delete operations