Vfx Agent Toolkit

vfx-agent-toolkit

Claude Code plugins and MCP connectors for VFX production. One clone gets you skills, agents, and app bridges for Nuke, Houdini, Unreal Engine, Blender, ComfyUI, Maya, Magnific, and Seedance.

Skills teach the agent the craft; connectors give it hands in the running applications. That split is the whole design.

Built by Rob Williams, a lead VFX artist working in production - every skill in here has shipped real work. Open-sourced so you can use it, fork it, and improve it. MIT licensed.

What is this?

Two things in one repo:

• Plugins (plugins\) teach Claude Code how to do VFX work. Each plugin is a bundle of skills (production-tested knowledge loaded on demand) and agents (specialized handlers for delegated tasks).
• Connectors (connectors\) wire Claude Code to your running applications via MCP (Model Context Protocol), so Claude can create nodes in Nuke, drive Houdini, control Unreal, and so on.

What it looks like in use

You say, in Claude Code with Blender (or Houdini) and Nuke running:

"Here's a photo of the building. Block it out in 3D matched to the photo, reskin it photoreal, and give me a Nuke comp with the reskin over the render passes."

One request, three applications, each driven over its own MCP connector:

1. Model from the photo. The agent studies the reference, blocks out the environment or object in Blender or Houdini (proportions, camera, lens matched to the photo), then renders clean control passes - grey clay, depth, normals, mattes.
2. Reskin via MCP. Those passes go to an image model (ComfyUI, Magnific, Nano Banana) through its connector, conditioned so the result holds the 3D layout instead of drifting. The agent compares each take against the reference and re-runs regional fixes rather than accepting the first output.
3. Comp in Nuke. The agent builds the comp over the Nuke MCP - Reads for the reskin and the passes, colourspace set correctly for AI-generated images, mattes from the 3D for regional grades, and a colour match back to the source photo - and renders a review frame.

Each stage is a skill (blender-controlnet-passes, magnific-image-gen, nuke-compositing, and 70+ more): the knowledge lives in the skill, the hands come from the connector. The same pattern drives Houdini scatter setups, UE PCG graphs, ComfyUI generation batches, and Seedance video passes.

Quickstart

1. Add the marketplace inside Claude Code:

   /plugin marketplace add sideshowroberto/vfx-agent-toolkit
   

2. Install the foundation plugin first, then the app plugins you need:

   /plugin install vfx-core@vfx-agent-toolkit
   /plugin install nuke-vfx@vfx-agent-toolkit
   

3. Run the core setup script once to register the shared MCP servers (brave-search, context7, desktop-commander) and optionally copy workspace templates:

   plugins\vfx-core\install.ps1
   

   brave-search needs a free API key from https://brave.com/search/api. context7 and desktop-commander need nothing.

4. For plugins that talk to a running application (Nuke, Houdini, Unreal, Blender, Maya, ComfyUI), clone this repo and run the matching connector installer:

   git clone https://github.com/sideshowroberto/vfx-agent-toolkit.git
   cd vfx-agent-toolkit
   connectors\nuke\install.ps1
   

5. Restart Claude Code. MCP servers load at startup, so any config change needs a restart.

The installers are PowerShell, so setup is Windows-first. The skills and agents themselves are plain markdown and work anywhere Claude Code runs.

Full walkthrough with expected output: docs/GETTING-STARTED.md

Plugins

Install vfx-core first. Everything else is per-project, install what you use. The full skill-by-skill index with trigger phrases is generated into docs/CAPABILITIES.md on every release.

Connectors

Connectors register MCP servers that bridge Claude Code to your applications. Details and per-app notes: connectors/README.md

Requirements

Per-application: Nuke 14+, Houdini 20+, Unreal Engine 5.8, Blender 4.5+ (for the bundled MCP add-on), Maya 2024+, a local ComfyUI install, and a Magnific account for the Magnific connector.

Repo layout

vfx-agent-toolkit\
+-- .claude-plugin\
|   +-- marketplace.json      Marketplace manifest (what /plugin reads)
+-- plugins\
|   +-- vfx-core\             Foundation: skills, agents, install.ps1, templates
|   +-- nuke-vfx\             Per-app plugins: skills\ + agents\ + plugin.json
|   +-- houdini-vfx\
|   +-- unreal-vfx\
|   +-- blender-vfx\
|   +-- comfyui-vfx\
|   +-- comfyui-node-dev\
|   +-- maya-vfx\
|   +-- magnific-vfx\
|   +-- seedance-vfx\
+-- connectors\
|   +-- nuke\                 install.ps1 + register.ps1 + bridge\
|   +-- houdini\
|   +-- unreal\
|   +-- maya\
|   +-- blender\              register.ps1 only (official Blender MCP)
|   +-- comfyui\
|   +-- magnific\
+-- docs\
|   +-- GETTING-STARTED.md
|   +-- ARCHITECTURE.md
+-- LICENSE

Attribution and provenance

This toolkit is a working collection: the majority of the skills, agents, and scripts are original creations, built and battle-tested in production. A handful are adapted from open source tools, community resources, and prompts we found useful along the way - some used as-is, some heavily modified. This collection grew organically inside a working pipeline, so the exact origin of every piece was not always tracked.

No claim of original authorship is made over anything that came from someone else. If you recognize your work in here and want credit added, a license noted, or the content removed, please open an issue - it will be handled promptly and gladly.

The MCP servers that the connectors register are separate projects by their own authors, not part of this toolkit:

Third-party tools keep their own licenses; the MIT license in this repo covers the original content of the toolkit itself.

Contributing

PRs welcome. Skills follow the standard Claude Code SKILL.md format: a skills\<skill-name>\SKILL.md file with name and description YAML frontmatter. Keep everything that ships ASCII-only and free of personal or studio-specific paths. See docs/ARCHITECTURE.md for the plugin format and a PR checklist.

License

MIT. See LICENSE.