blender-skills README

The project's README from github.com/arjun988/blender-skills. As one markdown file: README.md.

Blender Skills

Blender Skills

94 Specialized Skills for Blender Artists. Transform Cursor, Claude Code, Kiro, and Codex into your Senior Technical Art team — not a tutorial bot.

Version License Skills Blender MCP Cursor Claude Code Kiro Codex Website

Quick Start

Marketplace listing is currently under review by Anthropic. Install directly from GitHub in the meantime.

Works with Cursor, Claude Code, Kiro, and Codex — same skill pack, Blender MCP execution.

Claude Code

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

Cursor (Windows)

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

Kiro

# Copy skill folders into your Kiro skills directory, then restart Kiro
cp -r blender-skills/.claude/skills/* /path/to/kiro/skills/

Codex

# Mount or copy skills into your Codex skills path
cp -r blender-skills/.claude/skills/* /path/to/codex/skills/
# or: ln -s /path/to/blender-skills/.claude/skills /path/to/codex/skills/blender-skills

For all installation methods and first steps, see the Quick Start Guide.

Full documentation: blender-skills.vercel.app

Skills (94)

94 specialized skills across modeling, production, technical, pipeline, art styles, horror packs, worlds, moods, and gameplay genre direction.

See Skills Guide for the full list, subtype coverage map, decision trees, and workflow combinations.

Usage Patterns

Orchestrated Execution

The blender-director skill analyzes your request and routes automatically:

# Hard Surface Asset
"Build a game-ready sci-fi rifle for Unreal Engine, 3k tris, realistic PBR"
→ blender-director → hard-surface → uv-workflow → materials → asset-optimization → export-pipeline

# Environment
"Create a modular horror corridor kit — narrow, flickering fluorescent, Silent Hill feel"
→ blender-director → horror-style → environment-artist → lighting → export-pipeline

# Character
"Retopologize this creature sculpt for game animation, 15k triangle budget"
→ blender-director → retopology → uv-workflow → texture-workflow → rigging

Reference Image Matching

Attach a photo or concept art and the agent matches it:

"Match this reference — industrial spaceship, analyze first then build in Blender"
→ blender-director → reference-image-match
  → Camera match → Geometry tiers → Materials → Lighting → Screenshot comparison loop

Skill Categories

Category Skills
Orchestration blender-director
Modeling blender-modeler, hard-surface, prop-artist, vehicle-artist, environment-artist, vegetation-artist, character-artist, creature-artist, character-archetypes
Production sculpting, retopology, uv-workflow, materials, texture-workflow, hair-groom, cloth-sim, lookdev
Technical geometry-nodes, lighting, camera-cinematography, rendering, compositing, animation, rigging, vfx-fx, physics-sim
Pipeline procedural-modeling, scene-assembly, set-dressing, asset-optimization, lod-pipeline, collision-proxy, export-pipeline, unity-export, unreal-export, godot-export, qa-review, archviz
Core styles horror-style, psx-horror-style, lowpoly-style, anime-style, voxel-style, isometric-style, stylized-style, realistic-style
Extended styles cartoon, comic-book, manga, pixel-art, hand-painted, painterly, stop-motion-craft, chibi, noir, minimalist, vector, retro-8bit, retro-16bit, hd-2d, frutiger-aero
Horror packs cosmic-eldritch, body-horror, analog-found-footage, liminal-space, folk-horror, mascot-puppet, dream-weirdcore, indie-horror-aesthetics
Worlds / moods fantasy-worlds, sci-fi-punk-worlds, historical-worlds, apocalypse-worlds, biome-worlds, cozy-wholesome, dark-gritty, dream-surreal, neon-retrofuturism, brutalist
Genre direction action-combat, shooter, rpg, survival, stealth, puzzle-platformer, metroidvania-roguelike, soulslike, strategy-sim, racing-sports, narrative-vn, card-party-idle, open-world-sandbox
Eras visual-console-eras

Full paths and workflows: SKILLS_GUIDE.md.

Blender MCP

Every skill executes directly in Blender via MCP — no UI walkthroughs, no manual steps.

Blender (running) ← BlenderMCP addon ← Cursor / Claude Code / Kiro / Codex

Setup in 4 steps:

  1. Install uv
  2. Install the BlenderMCP addon in Blender
  3. Blender sidebar N → BlenderMCP → Connect to Claude
  4. Restart your agent — Cursor ships .cursor/mcp.json; Claude Code uses .mcp.json

Full guide: docs/BLENDER_MCP_SETUP.md

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

Workflow Pipelines

Hero Hard Surface Prop

blender-director → hard-surface → uv-workflow → materials → asset-optimization → export-pipeline

Game Character

blender-director → character-artist → sculpting → retopology
→ uv-workflow → texture-workflow → rigging → animation → export-pipeline

Horror Environment

blender-director → horror-style → environment-artist → lighting
→ lowpoly-style → asset-optimization → export-pipeline

Modular Kit

blender-director → environment-artist → geometry-nodes
→ uv-workflow → texture-workflow → asset-optimization → export-pipeline

Reference Image Match

blender-director → reference-image-match.md
  → Reference Analysis → Camera match → Geometry tiers
  → Materials → Lighting → Screenshot compare loop
  → visual-match-checklist → validation-checklist

Philosophy

Every skill in this pack:

Project Structure

.claude-plugin/           # Claude Code plugin manifest
.claude/skills/           # 94 skills + 175+ reference files
  ├── blender-director/
  ├── hard-surface/
  ├── prop-artist/
  ├── genre-shooter/
  ├── sci-fi-punk-worlds/
  ├── ... (89 more skills)
  └── references/         # Asset pipeline, naming, MCP tools, checklists
.cursor/skills/           # Synced mirror for Cursor
.cursor/mcp.json          # Blender MCP config (Cursor)
.mcp.json                 # Blender MCP config (Claude Code)
site/                     # Website (blender-skills.vercel.app)
docs/
  └── BLENDER_MCP_SETUP.md

Documentation

Doc Purpose
QUICKSTART.md Installation and first steps
SKILLS_GUIDE.md Skill index, decision trees, workflows
docs/BLENDER_MCP_SETUP.md Blender MCP connection guide
CONTRIBUTING.md How to add skills and contribute
CHANGELOG.md Version history
.claude/skills/references/ Shared pipeline standards

Contributing

See CONTRIBUTING.md for guidelines on adding skills, writing references, and submitting pull requests.

Changelog

See CHANGELOG.md for full version history and release notes.

License

MIT License — See LICENSE for details.

Support

Built for Cursor, Claude Code, Kiro & Codex | Blender MCP | 94 Skills | 175+ Reference Files

Inspired by jeffallan/claude-skills

blender-skills (arjun988/blender-skills)

blender-addon
Searching Database…

975 ·GitHub
Blender-skills
What is this?A pack of 94 specialized Blender skills that plug into AI coding agents (Cursor, Claude Code, Kiro, Codex) so they can actually do production-grade 3D work in Blender instead of just talking about it.
Is this a Blender add-on, or does it live inside my coding agent?It is a skill pack of files dropped into your agent's skills folder (e.g. .claude/skills or .cursor/skills); the actual Blender work happens through the separate BlenderMCP addon, which the skills call via MCP.
How do I get this running?Install uv, install the BlenderMCP addon inside Blender, open the Blender sidebar (N panel) and connect BlenderMCP to your agent, then restart the agent — Cursor and Claude Code ship their own mcp.json config.
Which coding agents does this work with?The same skill pack works with Cursor, Claude Code, Kiro, and Codex, all executing through Blender MCP.
Can I install it from my agent's skill marketplace yet?Not yet — the official marketplace listing is still under Anthropic review, so right now you have to install it directly from GitHub.
What does the blender-director skill do?It is the orchestration skill: it analyzes your request and automatically routes it to the right specialist skills in the pipeline, so you do not have to pick one yourself.
What skill categories are included?94 skills cover modeling, production, technical work, pipeline/export, core and extended art styles, horror packs, world/mood sets, and gameplay genre direction — from hard-surface props to Unity, Unreal, and Godot export.
Can it match a reference photo or concept art?Yes — attach an image and the agent analyzes it, camera-matches the shot, and loops screenshot comparisons against the reference until the Blender scene matches.
Does it validate its own output before finishing?Yes, every skill follows naming conventions and polycount budgets, then runs an asset-optimization and checklist gate before considering a delivery done.
What are similar projects?mcp-for-blender, skills, genex-desktop, threejs-architecture-effects, blender-production-skills, agent-sprite-forge, blender-plugin, godogen
Which topics is it in?blender-addon, 3d-models, cursor-ai, unity3d, character-animation, godot, unreal-engine, 3d-graphics, blender, 3d-modeling, procedural-generation, game-modding
Creator
arjun988
Size
0.7 MB
Stars
975
Updated
CommitJul 10
Age
3mo
Commits · 90 Days