assets-find

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

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill assets-find-fermisloth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assets-find
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/assets-find
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill assets-find-fermisloth

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 lets you query the Unity asset database programmatically by name, label, type, or folder scope and get back structured asset references. ## Core Features & Use Cases - Filter-Based Search: Find assets by filename, labels (l:), types (t:) such as Prefab, Material, or Shader, asset bundles (b:), and glob patterns. - Scoped Search: 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 follow-up operations. - Use Case: Ask the AI to find all Material assets in the Assets/Art folder, then use the returned paths and GUIDs to inspect or modify them with other Unity MCP tools. ## Quick Start Ask the AI to find all Prefab assets in your Unity project whose names contain the word Enemy.

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 Prefabs or Materials in Unity by type?

Use the t: prefix in the filter string, for example t:Prefab or t:Material. Supported types include AnimationClip, AudioClip, Mesh, 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 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 instead.

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

Each result is an asset reference containing the instanceID, asset type, project-relative asset path starting with Assets/, and the asset GUID. These identifiers can be passed to other Unity MCP tools for further operations.