CarlxsMG/UEAgent / Resources/Skills/ueagent-skill-builder
ueagent-skill-builder
VerifiedTurn an Unreal Editor workflow into a reusable skill built on UEAgent's MCP tools. It finds the tools the task needs, rehearses the task once in the editor, checks the result, and writes a SKILL.md with the tool sequence and the pitfalls it met. Use when the user asks to make, capture or automate an Unreal workflow as a skill, or to repeat a task they just did with the tools.
Skill builder
Turns a task the user wants to repeat in the Unreal Editor into a skill: a SKILL.md that tells an
agent which UEAgent tools to call, in what order, how to check the result and what goes wrong. The
skill is built from a real run, not from guesses: every step in it has worked once in this editor.
The workflow to capture is the one the user described.
1. Pin down the task
Agree with the user, briefly, on:
- The request, in the words they will use to ask for it again. These words become the trigger
phrases of the skill's
description. - What changes between runs: names, paths, counts, values. These become the skill's inputs.
- What "done" looks like, as something a tool can read back: an actor in the level, a Blueprint that compiles, an asset with a property set.
One skill does one task. If the request is really two, build two skills.
2. Find the tools
UEAgent's tools are the MCP tools of the Unreal Editor's server (named unreal when it was connected
from the editor's MCP menu). Each client names them its own way: mcp__unreal__spawn_actor in
Claude Code, for example. In the skill, write the plain tool name (spawn_actor): every client finds
it.
- If your client loads tools on demand, search for them by name or by keywords (
unreal spawn actor). - Otherwise search with
find_tools, read a schema withdescribe_tool, and run a tool that is not in your list withcall_tool;enable_toolsetadds a pack or a whole domain to the list. - The tool reference, with search, is at https://carlxsmg.github.io/UEAgent/tools/.
Read the whole description of every tool you pick: it names the traps (parameter forms, what it
refuses during Play-in-Editor, what it does not verify). Prefer the most specific tool, use execute_batch
for steps that do not depend on each other's answers, and keep execute_python for what no tool does.
3. Rehearse it in the editor
Run the sequence once, on a test target the user agrees to (a test level, a scratch folder), and read every answer:
success: false, or a refusal (isError): follow what the message says to do instead. A refusal withrefused_by: "policy"is the user's settings: stop and ask the user.- A
readbackwhoseverdictis notok: the call did not do what it reported; itsnotesays why. unknown_params: a parameter the tool ignored, so its name is wrong.
Each tool call is one undo step ("UEAgent: "): undo reverts the last one, so a failed attempt
can be rolled back and tried again. Confirm the end state with a read tool (get_*, list_*,
find_*), not with the success flags. Write down every trap you hit and how you got past it.
4. Write the skill
Save it next to UEAgent's own skills, in the folder the user's client reads:
- Claude Code:
.claude/skills/<name>/SKILL.mdin the project (or~/.claude/skills/for every project on this machine); - Codex, Cursor, VS Code, Antigravity CLI, Gemini CLI and OpenCode:
.agents/skills/<name>/SKILL.mdin the project.
Ask which client they use if you do not know it. Fill in template.md. Rules (the Agent Skills format, which every one of those clients reads):
name: lowercase letters, digits and hyphens, at most 64 characters, the same as its folder. Do not start it withueagent-: that prefix is UEAgent's own.description: at most 1024 characters; what the skill does and the requests that should trigger it.- Only the standard frontmatter fields (
name,description, and optionallylicense,compatibility,metadata), so every client reads it the same way. - Tool and parameter names exactly as the schemas spell them.
- What varies between runs is an input the skill asks for or takes from the request, never a value hardcoded from the rehearsal. No absolute paths from this machine except as examples.
- Each step: the tool, the arguments that matter, and what its answer must show.
- A Verify section with the read that proves the result, and a Pitfalls section with the traps from the rehearsal.
- Short: under 150 lines. Long background goes into a separate file next to
SKILL.md.
5. Test the new skill
Run it on a fresh target, not the one used in the rehearsal: ask for it the way the user will (or
invoke it by name, /<name> in Claude Code, $<name> in Codex), and fix the skill wherever the run
differed from what it says. Then tell the user where it was saved, how to invoke it, and which inputs
it asks for. A client that was already open may need a restart to see a new skill.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |