From taconotsandwich-unity-agentic-tools
Unity umbrella skill. Source of truth for all Unity Agentic Tools operations that do not require a reachable live editor bridge.
npx claudepluginhub joshuarweaver/cascade-code-languages-misc-2 --plugin taconotsandwich-unity-agentic-toolsThis skill is limited to using the following tools:
CLI: `unity-agentic-tools <command>`
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
CLI: unity-agentic-tools <command>
CRITICAL: Use the CLI for ALL Unity operations. NEVER manually read, edit, write, or grep Unity files (.unity, .prefab, .asset, .mat, .anim, .controller, .meta, ProjectSettings/) using Read, Edit, Write, or Grep tools. NEVER manually edit Unity C# scripts or Editor bridge code. The CLI handles YAML parsing, GUID preservation, and safe editing. Manual file access will break things.
Commands emit structured JSON by default.
This umbrella skill is authoritative for operations that do not require a reachable live editor bridge:
read ...update ... value editsdelete ...search, grep, clone, docs, version, setup, cleanup, statusIf the operation requires a reachable live editor bridge, load unity-agentic-editor instead.
Run unity-agentic-tools setup -p <project> before first use. Run unity-agentic-tools status to check readiness.
unity-agentic-tools --helpunity-agentic-tools statusunity-agentic-tools setup -p <project>unity-agentic-editor when it does.See reference/commands-read.md for full usage and options.
Core usage:
| Command | What it does |
|---|---|
read scene <file> | Hierarchy view for .unity / .prefab |
read gameobject <file> <object_id> | One object, optional component filter |
read component <file> <file_id> | One component by fileID |
read asset <file> | Generic Unity YAML asset read |
read material <file> | Material summary/properties |
read reference <file> <file_id> | Trace fileID references |
read dependencies <file> | Outbound GUID dependencies |
read dependents <guid> | Reverse dependency lookup |
read unused | Assets with zero inbound GUID references |
read target <file> <name> [type] | Build reference string for overrides |
read settings | Project settings by alias/name |
read build / read scenes | Build settings scene list |
read overrides <file> <prefab_instance> | Prefab overrides |
read script <file> / read scripts | Type extraction + registry search |
read meta <file> | Importer settings |
read animation <file> / read animator <file> | Animation/Animator inspection |
read manifest | Package manifest inspection |
read input-actions <file> | InputActions inspection |
See reference/commands-update.md for full usage and options.
This section covers only update operations that do not require a reachable live editor bridge.
Top-level update is intentionally limited to in-place value edits such as scalar, color, reference, importer, and default-value changes.
Scene / prefab mutation moved to unity-agentic-tools editor invoke UnityAgenticTools.Update.* ... under unity-agentic-editor.
See reference/commands-delete.md for full usage and options.
See reference/commands-utilities.md for full usage and options.
| Command | What it does |
|---|---|
search <path> [pattern] | GameObject search in file or project |
grep <pattern> | Regex search across project files |
clone <file> <object_name> | Duplicate GameObject hierarchy |
docs <query> | Search indexed Unity docs |
version | Read Unity version |
setup | Initialize .unity-agentic state |
cleanup | Remove .unity-agentic state |
status | Health and configuration report |
Inspect before mutate:
read ...)unity-agentic-toolsunity-agentic-editorread ...)See reference/workflows.md for end-to-end checklists.
unity-agentic-editor owns the invoke-based bridge surface: editor status, editor invoke, editor console-follow, editor list, editor install, editor uninstall.
get text/value @hN: @hN is hierarchy ref. get text/get value need UI refs (@uN from ui-snapshot). Use get position/get active/get component for hierarchy refseditor status, re-run editor install (or editor --project <path> install)scene-open fails: Use Assets-relative path (Assets/Scenes/Main.unity). Run editor invoke UnityEditor.AssetDatabase Refresh first for newly created scenes.unity/.prefab is currently loaded/open, pass --bypass-loaded-protection to force file-based edits