assets-find

Search Unity project assets by name, label, type, or folder using filter strings.

Updated May 28, 2026

Search Tags:#game development #unity #filter #asset search #editor automation #asset database #unity-mcp-cli

Ready to run

npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill assets-find-ishaansingh-ai

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: assets-find
Source: https://github.com/ishaansingh-ai/Mechanical-2D/tree/main/.claude/skills/assets-find
Command: npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill assets-find-ishaansingh-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Locating specific assets in a large Unity project is slow when done manually through the editor. This Skill queries the Unity asset database programmatically so you can find assets by name, label, type, or folder without opening the editor. ## Core Features & Use Cases - Filter-Based Search: Search assets by filename, labels (l:), types (t:) such as Prefab, Material, or Shader, asset bundles (b:), area (a:), and glob patterns. - Scoped and Limited Results: Restrict the search to specific folders and cap the number of returned results. - Structured Output: Returns asset references including instanceID, asset type, asset path, and GUID for use in downstream tooling. - Use Case: Find every Material asset labeled 'prototype' inside the Assets/Art folder to prepare a batch update of shaders. ## Quick Start Ask the AI to find all Prefab assets in the Unity project whose name contains 'Enemy' and limit the results to 20.

Frequently Asked Questions about assets-find

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

FAQPage Schema

How do I search for assets in a Unity project from the command line?▼

Run unity-mcp-cli with the assets-find tool and pass a filter string in JSON input. The filter supports name keywords, labels with l:, types with t:, and glob patterns, and results are returned as JSON asset references.

How do I find all assets of a specific type like Prefab or Material in Unity?▼

Use the t: prefix in the filter string, for example t:Prefab or t:Material. Supported types include AnimationClip, AudioClip, Mesh, Model, Scene, Script, Shader, Sprite, Texture, and more.

Can I limit the Unity asset search to specific folders?▼

Yes, pass the searchInFolders parameter as an array of folder paths to restrict where the search starts. If omitted or null, the search runs across all folders in the project.

Why is unity-mcp-cli not found when running the asset search?▼

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli or invoke it through npx unity-mcp-cli, then retry the command.

What does the assets-find tool return for each matching asset?▼

Each result is an asset reference containing the instanceID, asset type, project-relative asset path starting with Assets/, and the asset GUID. Results can be truncated with the maxResults parameter.