Getting Started

v1.3.0

Getting Started

Install Blender Skills in Cursor, Claude Code, Kiro, or Codex, then connect Blender MCP for live execution.

Supported Agents

Cursor

Project skills in `.cursor/skills/` with Blender MCP via `.cursor/mcp.json`.

Claude Code

Native Claude skills under `.claude/skills/` with project `.mcp.json`.

Kiro

Drop the same skill folders into your Kiro agent skills path and point MCP at Blender.

Codex

Use the skill pack as agent instructions/skills alongside Blender MCP for Codex workflows.

Installation

Marketplace listing under review

Install directly from GitHub for all platforms until marketplace install is available.

1. Clone the repo

git clone https://github.com/arjun988/blender-skills.git

2. Claude Code

Copy skills into your project's .claude/skills/ folder.

cp -r blender-skills/.claude/skills /path/to/your/project/.claude/skills/
# Restart Claude Code after copying

3. Cursor

Copy into Cursor project skills (Windows PowerShell example):

Copy-Item -Recurse -Force "blender-skills\.claude\skills\*" ".cursor\skills\"
# Restart Cursor after copying

macOS/Linux: cp -r blender-skills/.claude/skills/* .cursor/skills/

4. Kiro

Kiro uses agent skills folders similarly — copy the skill directories into your Kiro skills path (project or user skills, depending on your Kiro setup), then restart Kiro.

# Example: copy into your Kiro skills directory
cp -r blender-skills/.claude/skills/* /path/to/kiro/skills/
# Point Blender MCP at the same BlenderMCP addon session

5. Codex

Mount or copy .claude/skills into your Codex skills / instructions path so the agent can discover SKILL.md files. Configure Blender MCP the same way you would for other MCP-capable clients.

# Example: symlink skills into Codex skills path
ln -s /path/to/blender-skills/.claude/skills /path/to/codex/skills/blender-skills
# Or copy: cp -r blender-skills/.claude/skills/* /path/to/codex/skills/

Connect Blender MCP

Every skill executes inside Blender via the BlenderMCP addon. 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 → BlenderMCP tab → Connect to Claude (works as the MCP bridge for all clients).

Restart your agent client

This repo ships MCP config for Cursor and Claude Code. Kiro and Codex should point at the same BlenderMCP server once skills are installed.

Config / Path	Client
.cursor/mcp.json + .cursor/skills/	Cursor
.mcp.json + .claude/skills/	Claude Code
Kiro skills dir + Blender MCP	Kiro
Codex skills path + Blender MCP	Codex

Verify Setup

Skills visible (94 expected) — 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 — it plans the pipeline and routes genre, style, and discipline skills.

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

The agent will:

Activate blender-director → production brief
Route to hard-surface + realistic-style + unity-export
Execute via Blender MCP
Validate with asset-optimization / qa-review

Example Prompts

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

“Build a liminal Backrooms lobby — fluorescent hum, stained carpet, endless doors”

“Cyberpunk street vendor stall, neon-retrofuturism, Unreal export with UCX”

“Soulslike chapel interior, dark fantasy, fog gate landmark”

“HD-2D forest clearing, pixel party characters, theatrical DoF”

“JRPG starter town, cozy mood, hand-painted materials”

“Model a game-ready sedan for Unreal with LODs and UCX collision”

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

Troubleshooting

Skills not activating

Ensure skills are in the correct path for your client (Cursor .cursor/skills/, Claude Code .claude/skills/, or your Kiro/Codex skills directory). Restart 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.

Next Steps

Browse all 94 skills Contribute a skill