feat(skills): enhance blender-mcp with comprehensive references and recipes

[kshitijk4poor]

Summary

Comprehensive enhancement of the existing blender-mcp optional skill. Replaces the minimal 116-line SKILL.md with a full-featured 863-line skill (4 files) including reference documentation, pitfalls, and ready-to-use recipes.

Supersedes #10191 (which created a separate hermes-blender skill — now closed in favor of updating the existing slot).

Changes

SKILL.md (116 → 270 lines):

• Full first-time setup guide (brew install, addon download, verification)
• Optional Hermes MCP config (uvx + pip methods)
• blender_exec() + blender_cmd() dual helper pattern
• 10 available commands table (was 4)
• 12 object types reference table
• Key implementation rules section
• Links to reference files

New: references/bpy-api.md (264 lines):

• Scene & object manipulation
• Transforms (location, rotation, scale)
• Mesh creation with bmesh
• Materials (Principled BSDF, emission, glass)
• Modifiers (subdiv, solidify, boolean, array)
• Camera & lighting (point, sun, area, HDRI)
• Rendering (Cycles, EEVEE, resolution, output)
• Animation keyframes
• Collections

New: references/pitfalls.md (106 lines):

• 19 documented pitfalls from real Blender sessions
• Covers: connection issues, Python execution quirks, engine name differences across versions, render timeouts, port conflicts
• Critical: execute_code result is always empty in Blender 5.x — documented workaround

New: references/recipes.md (223 lines):

• 5 complete copy-paste recipes:
  1. Low-poly landscape with terrain displacement
  2. Glass sphere on reflective plane (three-point lighting)
  3. Procedural donut (simplified Blender Guru style)
  4. Turntable animation with linear interpolation
  5. Render to file with verification

Credit

Original blender-mcp skill by @alireza78a (PR #1531). Author credit preserved in frontmatter.

Testing

Tested with Blender 5.1.1 on macOS via the blender_exec() socket pattern. Verified: object creation, material assignment, EEVEE rendering, scene export.

[teknium1]

Salvaged and merged in #65116 — thank you for this contribution!

Your three reference files (bpy-api.md, recipes.md, pitfalls.md) are now part of the blender-mcp optional skill (v2.1.0), cherry-picked with your authorship preserved in git history, and you're credited in the skill's author: field.

Between April and now the skill's interaction surface changed: it was reworked (#65066) around the curated blender MCP catalog entry (hermes mcp install blender, pinned version, curated tool set), so the raw-socket blender_exec() approach your SKILL.md rewrite extended is no longer the supported path. We therefore took the reference library (the durable value — your pitfalls in particular caught things nothing else in the repo documents, like the empty execute_code results in Blender 5.x and the temp-file readback pattern) and translated the socket-specific advice to the MCP-tool frame, while dropping the SKILL.md rewrite itself.

Closing since the salvage is merged. Thanks again!