unity-asset

Manage Unity AssetDatabase operations including import, move, delete, and label queries.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-asset-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-asset
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/asset
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-asset-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Organizing, importing, moving, and querying Unity project assets through the editor UI is slow and error-prone, especially when handling many files at once. This Skill exposes AssetDatabase operations as callable skills so an AI agent can script asset management directly. ## Core Features & Use Cases - Batch-first asset operations: Import, delete, move, and create folders for multiple assets in a single call using *_batch variants with JSON item arrays. - Asset search and metadata: Find assets with Unity search filter syntax (t:Texture2D, l:Label, name), and read or set asset info and labels. - Safety-aware execution modes: Read-only queries run in SemiAuto mode, write operations require FullAuto grants, and high-risk import/delete operations are restricted to Bypass or allowlisted contexts. - Use Case: Reorganize a project by moving dozens of textures from Assets/Old/ into Assets/Textures/ with one asset_move_batch call, then verify results with asset_find. ## Quick Start Ask the agent to find all Texture2D assets in the project and move them into a new Assets/Textures folder using the batch move operation.

Frequently Asked Questions about unity-asset

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move multiple Unity assets at once?

Use asset_move_batch with an items parameter containing a JSON array of sourcePath and destinationPath objects. This performs all moves in a single API call instead of one call per asset.

How do I search for assets in a Unity project by type?

Use asset_find with Unity search filter syntax, such as t:Texture2D for type, l:Label for labels, or plain text for names. Filters can be combined, for example 't:Material player', and results can be capped with the limit parameter.

Why does asset_import or asset_delete return MODE_FORBIDDEN?

These are high-risk operations marked RiskLevel high or Operation.Delete, so they are blocked in Approval and Auto modes. They only run in Bypass mode or when the caller matches an allowlist entry.

Does this skill support renaming Unity assets?

There is no asset_rename skill. Use asset_move with the same folder but a new file name in destinationPath to rename an asset.

What causes TARGET_NOT_FOUND or SEMANTIC_INVALID errors?

TARGET_NOT_FOUND means the source file or asset path does not exist; verify it with asset_find first. SEMANTIC_INVALID means the path is malformed, contains '..', or does not start with Assets/ or Packages/.