blender-toolkit

Automates Blender geometry creation, materials, modifiers, and Mixamo animation retargeting via WebSocket.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill blender-toolkit-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-toolkit
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/blender
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill blender-toolkit-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manually creating 3D geometry, configuring materials, and retargeting Mixamo animations onto custom rigs in Blender is repetitive and error-prone, especially when bone names differ between rigs. This Skill provides CLI-driven, WebSocket-based control of Blender so these tasks can be automated and verified. ## Core Features & Use Cases - Geometry & Object Automation: Create primitives (cube, sphere, cylinder, cone, torus), transform, duplicate, subdivide, and delete objects through CLI commands. - Material & Modifier Management: Create materials, set PBR properties (color, metallic, roughness), assign them to objects, and manage modifiers. - Mixamo Animation Retargeting: Retarget Mixamo FBX animations to custom rigs using fuzzy bone matching with quality assessment and a two-phase UI confirmation workflow. - Use Case: Download a Walking animation FBX from Mixamo, then run a retarget command against your character's armature; the system auto-generates a bone mapping, shows it in Blender's sidebar for review, and bakes the animation to an NLA track after confirmation. ## Quick Start Ask the assistant to check the Blender addon installation status and then create a sphere with radius 1.5 in the running Blender scene.

Frequently Asked Questions about blender-toolkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retarget a Mixamo animation to a custom rig in Blender?

Download the animation as FBX (without skin, 30 fps) from Mixamo, then run the retarget command with your target armature name and FBX path. The system auto-generates a bone mapping with fuzzy matching, displays it in Blender's sidebar for review, and applies the retargeting after you confirm.

How do I create 3D primitives in Blender from the command line?

Use the blender-toolkit CLI commands such as create-cube, create-sphere, or create-cylinder with size and position parameters. Commands are sent over WebSocket to the running Blender instance, which must have the addon's server started.

What Blender version is required for WebSocket automation?

Blender 4.0 or later is required. The Blender Toolkit addon must be installed and enabled, and its WebSocket server started from the 3D View sidebar, using ports in the 9400-9500 range.

Can I download Mixamo animations automatically with an API?

No, Mixamo does not provide an official API, so FBX files must be downloaded manually from Mixamo.com. The skill provides download instructions and recommended settings, then proceeds with retargeting once you supply the file path.

Why does bone mapping produce poor quality results on my rig?

Poor quality ratings occur when fewer than four of the nine critical bones match, usually due to unconventional bone naming. Review bone names in Edit Mode, lower the similarity threshold below the default 0.6, or supply a custom explicit bone mapping.

What should I do when the Blender WebSocket connection fails?

Verify Blender is open, the addon is enabled, and the server is started via the Blender Toolkit sidebar tab. Check the config file for the correct blenderExecutable path and review logs in the .blender-toolkit directory.