Unity Asset Skills

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

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 asset
•asset_find - Search assets (returns list)
•asset_create_folder - Create folder
•asset_refresh - Refresh AssetDatabase
•asset_get_info - Get asset information

Skills

asset_import / asset_import_batch

Import external files into the project.

Parameter	Type	Required	Description
`sourcePath`	string	Yes	External file path
`destinationPath`	string	Yes	Project destination

python

# Single
unity_skills.call_skill("asset_import",
    sourcePath="C:/Downloads/texture.png",
    destinationPath="Assets/Textures/texture.png"
)

# Batch
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 / asset_delete_batch

Delete assets from the project.

Parameter	Type	Required	Description
`assetPath`	string	Yes	Asset path to delete

python

# Single
unity_skills.call_skill("asset_delete", assetPath="Assets/Textures/old.png")

# Batch
unity_skills.call_skill("asset_delete_batch", items=[
    {"path": "Assets/Textures/old1.png"},
    {"path": "Assets/Textures/old2.png"}
])

asset_move / asset_move_batch

Move or rename assets.

Parameter	Type	Required	Description
`sourcePath`	string	Yes	Current asset path
`destinationPath`	string	Yes	New path/name

python

# Single (also works for rename)
unity_skills.call_skill("asset_move",
    sourcePath="Assets/Materials/Red.mat",
    destinationPath="Assets/Materials/Player/RedMetal.mat"
)

# Batch
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

Example: Efficient Asset Organization

python

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