generate-editor-search-query
An agent skill by Unity-Technologies, from Unity-Technologies/unity-agent-plugin. Tags: cli, editor, search, unity, validation.
What it does
Generates Unity Search / Quick Search queries and opens the Unity Search window for read-only Unity Editor asset or scene-object lookup requests. Always use when the user asks to find, search, show, locate, filter, look up, query, or list concrete assets or scene objects in the current project or scene, even if Unity Search is not named. Covers materials, textures, prefabs, scenes, scripts, shaders, GameObjects, components, Lights, Cameras, UI objects, labels, paths, references, selected or named assets, and asset types. Also use when the user explicitly mentions Unity Search, Quick Search, Search window, open Search, or asks what Unity Search query to use. Do not use for general project overview, project structure, folder-purpose summaries, gameplay/system explanations, how-to programming questions, web search, repository text search, build logs, package installation, menu or settings search, modifying results, or non-Unity filesystem search unless the user explicitly asks to use Unity Search.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add Unity-Technologies/unity-agent-plugin --skill generate-editor-search-query
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/Unity-Technologies/unity-agent-plugin
cp -r unity-agent-plugin/skills/generate-editor-search-query ~/.claude/skills/generate-editor-search-query
Safety box score
Grade B, low risk: 14 of 100 risk points, rated 2026-10-15. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill only translates Unity Editor search requests into Search queries and, by default, can open the Unity Search window in the user's running Editor. The main risk is limited Editor-side code execution via `unity command eval`; otherwise it is designed to be read-only and does not edit assets, scenes, or credentials.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 2 (moderate) | It runs Editor-side C# through `unity command eval --caller plugin --skill generate-editor-search-query --code '<snippet>'` and the snippet calls `UnityEditor.Search.SearchService.ShowWindow(context)`. |
| Network access | 0 (none) | No file download, upload, or remote post behavior is present; SECURITY.md explicitly says 'No remote code'. |
| Filesystem reach | 1 (low) | The opener instructions say to 'Write the query to a temporary file' and 'Delete the temporary file afterwards,' which touches the filesystem in a limited way. |
| Secrets & credentials | 0 (none) | The skill does not access tokens, `.env` files, keychains, browser sessions, or other credentials. |
| Privilege & persistence | 0 (none) | It does not request sudo, install system-wide software, register services, or change shell/OS settings. |
| Instruction hijack surface | 0 (none) | There are no hidden instructions, prompt-skipping rules, or remote instruction fetching; the query text is base64-encoded to avoid code injection. |
| Irreversible actions | 1 (low) | By default it can automatically open the Search window for the user, but it does not act on results or modify project data. |
| Transparency | 0 (none) | All shipped files are plain markdown and the only code snippet is fully visible; there are no binaries or decoded-at-runtime blobs. |
Before installing
- Read `references/open-search-window.md` and confirm you're okay with `unity command eval` running in your open Unity Editor.
- Try it first in a non-sensitive project/session so an automatic Search window open is acceptable.
- Verify your Unity version exposes `UnityEditor.Search` and the Pipeline `eval` capability.
- Use `query only` or `do not open Search` when you want text output without any Editor action.
Rated 2026-10-15 by an automated review of 4 files from the skill's repository.
Source
- Repository
- Unity-Technologies/unity-agent-plugin (all skills from this repository)
- Path
- skills/generate-editor-search-query/SKILL.md
- Branch
- main
- Updated
- 2026-09-22
Related skills
- check-compiler-errors — Run compile and type-check commands and report failures
- cli-for-agents — Designs or reviews CLIs so coding agents can run them reliably: non-interactive flags, layered --help with examples, stdin/pipelines, fast actionable errors.
- control-cli — Build or adapt a local harness to drive, inspect, and profile an interactive CLI or TUI without external services.
- schema — When the user wants to add, fix, or optimize schema markup and structured data on their site.
- seo-geo — Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.
- seo-local — Local SEO analysis covering Google Business Profile optimization, NAP consistency, citation health, review signals, local schema markup, location page quality.