메뉴
Use when users want to import, move, delete, duplicate, or organize project assets.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | unity-asset |
| description | Use when users want to import, move, delete, duplicate, or organize project assets. |
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
*_batchskills when operating on 2+ assets.
| Single | Batch | Use Batch When |
|---|---|---|
asset_import | asset_import_batch | Importing 2+ files |
asset_delete | asset_delete_batch | Deleting 2+ assets |
asset_move | asset_move_batch | Moving 2+ assets |
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.
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 pathasset_search does not exist → use asset_find with searchFilter syntax (e.g. t:Texture2D player)asset_copy does not exist → use asset_duplicateRouting:
importer modulematerial modulescript moduleImport an external file into the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
sourcePath | string | Yes | External file path |
destinationPath | string | Yes | Project destination |
Import multiple external files.
items currently expects a JSON string, not a native array.
Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}
Delete an asset from the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset path to delete |
Delete multiple assets.
items currently expects a JSON string, not a native array.
Returns: {success, totalItems, successCount, failCount, results: [{success, path}]}
Move or rename an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
sourcePath | string | Yes | Current asset path |
destinationPath | string | Yes | New path/name |
Move multiple assets.
items currently expects a JSON string, not a native array.
Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}
Duplicate an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset to duplicate |
Find assets by search filter.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
searchFilter | string | Yes | - | Search query |
limit | int | No | 50 | Max results to return |
Search Filter Syntax:
| Filter | Example | Description |
|---|---|---|
t:Type | t:Texture2D | By type |
l:Label | l:Architecture | By label |
name | player | By name |
| Combined | t:Material player | Multiple filters |
Returns: {success, count, assets: [path]}
Create a folder in the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
folderPath | string | Yes | Full folder path |
Refresh the AssetDatabase after external changes.
No parameters.
Get information about an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset path |
Force reimport of an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset path to reimport |
Reimport multiple assets matching a pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
searchFilter | string | No | AssetDatabase search filter (default *) |
folder | string | No | Folder root to search (default Assets) |
limit | int | No | Max assets to reimport (default 100) |
Set labels on an asset (overwrites existing labels).
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset path |
labels | string | Yes | Comma-separated labels (e.g. "ui,icon,hud"). Empty entries are dropped |
Returns: {success, assetPath, labels: [...]}
Get the labels currently attached to an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath | string | Yes | Asset path |
Returns: {success, assetPath, labels: [...]}
Recipe path rule: ../../recipes/asset/<command>.md
Use when working with a Unity project via MCP — creating or editing scenes, GameObjects, components, prefabs, materials, UI, lighting, navmesh, animations, terrain, C# scripts, or any other Unity Editor task.
Use when users want to run Unity tests or read test results.
Use when users want to enter play mode, select objects, undo/redo, or execute menu commands.
Use when creating, reading, editing, searching, validating, or deleting C# scripts in a Unity project.
Use when about to write or install a custom Editor script, add a [MenuItem], build a custom Editor window, or create a one-off Editor helper — to check whether a ready-to-paste template already exists in tooling/<domain>/ before reaching for Unity_CreateScript.
Use when users want to create Canvas, Button, Text, Image, or other UI elements.