Blender Skills

Getting Started

Get up and running with Blender Skills in Claude Code or Cursor with Blender MCP.

Installation

🕐 Marketplace listing under review

The Claude Code marketplace submission is currently being reviewed by Anthropic. In the meantime, install directly from GitHub using the methods below.

Install from GitHub — Claude Code

Clone the repo and copy skills into your project.

git clone https://github.com/arjun988/blender-skills.git
cp -r blender-skills/.claude/skills /path/to/your/project/.claude/skills/

Restart Claude Code after copying.

Install from GitHub — Cursor

Copy skills to Cursor's project skills folder (Windows).

git clone https://github.com/arjun988/blender-skills.git
Copy-Item -Recurse -Force "blender-skills\.claude\skills\*" ".cursor\skills\"

Restart Cursor after copying.

Connect Blender MCP

Every skill executes directly inside Blender via the BlenderMCP addon. This is required for MCP execution — without it, skills fall back to instructions only.

Install uv

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Install the BlenderMCP addon in Blender

Download addon.py then in Blender:

Edit → Preferences → Add-ons → Install → select addon.py → Enable "Blender MCP"

Start the MCP server in Blender

In the Blender 3D Viewport press N to open the sidebar → find the BlenderMCP tab → click Connect to Claude.

Restart Cursor / Claude Code

This repo ships preconfigured MCP config files — no manual editing needed:

Config File	Client
.cursor/mcp.json	Cursor (project)
.mcp.json	Claude Code (project)

Verify Setup

Skills visible in agent context (try mentioning "blender-director")

Blender MCP connected (green status in addon panel)

Test: "List objects in the current Blender scene"

Collections use COL_ prefix, meshes use SM_ prefix

First Prompt

Start with blender-director on any complex task — it plans the pipeline and routes to the right skills automatically.

Plan and create a game-ready sci-fi crate for Unity — 1500 tris, realistic PBR, export to FBX

The agent will:

Activate blender-director → output production brief
Route to hard-surface + realistic-style
Execute via Blender MCP (not UI walkthroughs)
Validate with asset-optimization → export-pipeline

Example Prompts

“Match this reference photo — industrial spaceship, analyze first then build in Blender”

“Create a modular sci-fi wall kit for Unreal Engine with 2m grid snapping”

“Block out a horror corridor inspired by Silent Hill — narrow, flickering fluorescent”

“Retopologize this creature sculpt for game animation, 15k triangle budget”

“Export this character with walk cycle to FBX for Unity”

“Scatter rocks on this cliff using geometry nodes, then bake for export”

Troubleshooting

Skills not activating

Ensure skills are in .cursor/skills/ (Cursor) or .claude/skills/ (Claude Code). Restart the client after copying.

MCP not connecting

Usually a uv PATH issue or the BlenderMCP addon wasn't started. See BLENDER_MCP_SETUP.md.

Agent describes UI instead of executing

Remind it: “Use Blender MCP tools” — skills enforce MCP-first in mcp-integration.md.

Next Steps

Browse all 23 skills Contribute a skill