Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package

73 deterministic skills + Blender MCP integration enabling Claude AI to generate and execute flawless Blender/BIM/IFC/Sverchok code.
Built with the Open-Agents multi-agent orchestration framework.

Blender MCP: Live Connection to Blender

This package includes a pre-configured .mcp.json that connects Claude Code directly to a running Blender instance via the Blender MCP server. This means Claude can read your scene, execute Python code in Blender, and take viewport screenshots in real time.

Claude Code ──MCP Protocol──> blender-mcp server ──TCP:9876──> Blender Addon ──bpy──> Blender Scene

Quick start (if you already have the prerequisites)

1. Install the Blender MCP addon in Blender (Edit > Preferences > Add-ons > Install from Disk)
2. In Blender, open the sidebar (N), go to the BlenderMCP tab, click "Connect to Claude"
3. Start Claude Code in this workspace. The .mcp.json is already configured.

Full setup guide

See SETUP.md for complete step-by-step installation instructions covering:

• Node.js, Claude Code CLI, uv package manager
• Blender MCP addon installation (the bridge between Claude and Blender)
• Bonsai/IfcOpenShell/Sverchok addon installation
• MCP configuration and troubleshooting

Why This Exists

Claude is powerful, but without domain-specific guidance it generates BIM/IFC code that looks correct but fails in production.

The #1 cause of AI-generated IFC failures:

# WRONG - This creates an orphan entity with no relationships
wall = ifc_file.create_entity("IfcWall")

# CORRECT - API ensures valid ownership, relationships, and GlobalId
wall = ifcopenshell.api.run("root.create_entity", ifc_file,
    ifc_class="IfcWall", name="Wall_001")

This skill package solves it by giving Claude exact API syntax, decision trees, error diagnostics, and version-aware patterns for every operation.

Skill Packages

Each package is standalone — install only the technologies you work with.

See INDEX.md for the full skill catalog with descriptions.

Skill Categories

Installation

First time? Follow the complete SETUP.md guide. It covers everything from installing Node.js to verifying the Blender MCP connection.

Claude Code (CLI)

Option 1 — Copy skills + MCP config into your project:

# Clone the repository
git clone https://github.com/OpenAEC-Foundation/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package.git

# Copy skills into your project
cp -r Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/skills/blender/ your-project/.claude/skills/blender/
cp -r Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/skills/ifcopenshell/ your-project/.claude/skills/ifcopenshell/

# Copy the Blender MCP configuration
cp Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/.mcp.json your-project/.mcp.json

Option 2 — Install via OpenAEC Workspace Composer:

The Workspace Composer sets up a complete workspace with skills and MCP configuration automatically. Select the "Blender/Bonsai" package and the composer handles the rest.

Option 3 — Install per-package (use only what you need):

# Only Blender skills
cp -r skills/blender/ your-project/.claude/skills/blender/

# Only IfcOpenShell skills
cp -r skills/ifcopenshell/ your-project/.claude/skills/ifcopenshell/

# Only Bonsai skills
cp -r skills/bonsai/ your-project/.claude/skills/bonsai/

# Only Sverchok skills
cp -r skills/sverchok/ your-project/.claude/skills/sverchok/

# Cross-technology workflows
cp -r skills/aec-cross-tech/ your-project/.claude/skills/aec-cross-tech/

# Always include the MCP config for Blender connectivity
cp .mcp.json your-project/.mcp.json

Version Compatibility

Methodology

Built using the 7-phase research-first methodology proven in the ERPNext Skill Package:

Core principle: Research first, then build. Never create skills based on assumptions.

Skills were created in parallel via Open-Agents multi-agent orchestration, with each skill validated against official documentation and real-world usage.

Documentation

Related Projects

Companion Skills: Cross-Technology Integration

This package covers Blender, Bonsai, IfcOpenShell, and Sverchok as individual technologies. When you need to bridge these tools with other AEC software, install the companion cross-technology package:

Cross-Tech AEC Integration Skills — 15 skills for technology boundaries

Relevant cross-tech skills for Blender/Bonsai users:

License

MIT License — see LICENSE.

Part of the OpenAEC Foundation ecosystem.