noah-zll Unity Asset Skills
BATCH-FIRST: Use
*_batchskills when operating on 2+ assets.
Guardrails
Mode: Semi-Auto (available by default)
DO NOT (common hallucinations):
asset_createdoes not exist → useasset_create_folder(folders),material_create(materials),script_create(scripts)asset_renamedoes not exist → useasset_movewith new pathasset_searchdoes not exist → useasset_findwith searchFilter syntax (e.g.t:Texture2D player)asset_copydoes not exist → useasset_duplicate
Routing:
- For texture/model/audio import settings → use
importermodule (Full-Auto) - For material creation → use
materialmodule (Full-Auto) - For script creation → use
scriptmodule
Skills Overview
| Single Object | Batch Version | 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- Duplicate single assetasset_find- Search assets (returns list)asset_create_folder- Create folderasset_refresh- Refresh AssetDatabaseasset_get_info- Get asset informationasset_reimport- Force reimport assetasset_reimport_batch- Reimport multiple assets
Skills
asset_import
Import an external file into the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
sourcePath |
string | Yes | External file path |
destinationPath |
string | Yes | Project destination |
asset_import_batch
Import multiple external files.
Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}
unity_skills.call_skill("asset_import_batch", items=[
{"sourcePath": "C:/Downloads/tex1.png", "destinationPath": "Assets/Textures/tex1.png"},
{"sourcePath": "C:/Downloads/tex2.png", "destinationPath": "Assets/Textures/tex2.png"}
])
asset_delete
Delete an asset from the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath |
string | Yes | Asset path to delete |
asset_delete_batch
Delete multiple assets.
Returns: {success, totalItems, successCount, failCount, results: [{success, path}]}
unity_skills.call_skill("asset_delete_batch", items=[
{"path": "Assets/Textures/old1.png"},
{"path": "Assets/Textures/old2.png"}
])
asset_move
Move or rename an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
sourcePath |
string | Yes | Current asset path |
destinationPath |
string | Yes | New path/name |
asset_move_batch
Move multiple assets.
Returns: {success, totalItems, successCount, failCount, results: [{success, sourcePath, destinationPath}]}
unity_skills.call_skill("asset_move_batch", items=[
{"sourcePath": "Assets/Old/mat1.mat", "destinationPath": "Assets/New/mat1.mat"},
{"sourcePath": "Assets/Old/mat2.mat", "destinationPath": "Assets/New/mat2.mat"}
])
asset_duplicate
Duplicate an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath |
string | Yes | Asset to duplicate |
asset_find
Find assets by search filter.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
searchFilter |
string | Yes | - | Search query |
searchInFolders |
string | No | "Assets" | Folder to search |
limit |
int | No | 100 | Max results |
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]}
asset_create_folder
Create a folder in the project.
| Parameter | Type | Required | Description |
|---|---|---|---|
folderPath |
string | Yes | Full folder path |
asset_refresh
Refresh the AssetDatabase after external changes.
No parameters.
asset_get_info
Get information about an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath |
string | Yes | Asset path |
asset_reimport
Force reimport of an asset.
| Parameter | Type | Required | Description |
|---|---|---|---|
assetPath |
string | Yes | Asset path to reimport |
asset_reimport_batch
Reimport multiple assets matching a pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | Yes | Search pattern (e.g., "Assets/Textures/*.png") |
Example: Efficient Asset Organization
import unity_skills
# BAD: 4 API calls
unity_skills.call_skill("asset_move", sourcePath="Assets/tex1.png", destinationPath="Assets/Textures/tex1.png")
unity_skills.call_skill("asset_move", sourcePath="Assets/tex2.png", destinationPath="Assets/Textures/tex2.png")
unity_skills.call_skill("asset_move", sourcePath="Assets/tex3.png", destinationPath="Assets/Textures/tex3.png")
unity_skills.call_skill("asset_move", sourcePath="Assets/tex4.png", destinationPath="Assets/Textures/tex4.png")
# GOOD: 1 API call
unity_skills.call_skill("asset_move_batch", items=[
{"sourcePath": "Assets/tex1.png", "destinationPath": "Assets/Textures/tex1.png"},
{"sourcePath": "Assets/tex2.png", "destinationPath": "Assets/Textures/tex2.png"},
{"sourcePath": "Assets/tex3.png", "destinationPath": "Assets/Textures/tex3.png"},
{"sourcePath": "Assets/tex4.png", "destinationPath": "Assets/Textures/tex4.png"}
])
Best Practices
- Organize assets in logical folders
- Use consistent naming conventions
- Refresh after external file changes
- Use search filters for efficiency
- Backup before bulk delete operations