blender-python-integration

Este extracto es una copia guardada durante la revisión. La fuente externa contiene la versión completa y actual.

---
name: blender-python-integration
description: Workflow for using Claude to generate Blender Python scripts, automate 3D workflows, and create procedural scenes, animations, and assets directly inside Blender.
---

# Blender Python Integration

## Overview

This skill enables Claude to generate and refine Blender Python scripts for automating 3D workflows inside Blender.

The workflow focuses on:
- Blender Python scripting
- procedural scene generation
- animation automation
- object creation
- material automation
- scene setup
- workflow acceleration

The goal is to allow users — even without deep Blender experience — to create complex scenes, animations, and procedural systems through AI-assisted scripting.

Instead of manually building everything through the Blender UI, Claude can generate executable Blender Python code that automates repetitive or technically complex workflows.

---

# Setup

Before starting:

1. Install Blender:
   https://www.blender.org

2. Open Blender.

3. Switch to the **Scripting Workspace**.

4. Ensure the Python Console and Text Editor are visible.

5. Create a new script inside Blender.

Recommended tools:
- Blender
- VS Code (optional)
- Blender Python API documentation
- Reference images or animation concepts

Optional:
- Git for script versioning
- Add-ons for asset libraries

---

# Inputs Required

- Scene idea or animation goal
- Object requirements
- Animation behavior
- Material or lighting requirements

Optional:
- Existing Blender project
- Reference renders
- Procedural generation goals
- Geometry Nodes workflows

---

# When to Use This Skill

Use this skill when:
- automating Blender workflows
- generating procedural scenes
- building animations programmatically
- creating repetitive geometry
- scripting object generation
- accelerating complex setup tasks
- creating Blender scenes without deep manual experience

---

# When NOT to Use

Do NOT use this skill for:
- purely manual sculpting workflows
- hand-crafted artistic detailing
- UI-only Blender tutorials
- non-Blender 3D software pipelines

---

# Example Use Case

> Create a procedural sci-fi animation in Blender entirely through Python scripting.

Claude should:

1. Generate Blender Python code
2. Create objects procedurally
3. Position cameras and lights
4. Animate scene elements
5. Apply materials automatically
6. Configure rendering settings
7. Export the final animation

Final result should:
- automate repetitive setup
- remain editable
- generate consistent results
- accelerate scene creation
- reduce manual Blender work significantly

---

# Core Blender Python Principles

## 1. Automate Repetitive Work

Blender scripting is most valuable when automating repetitive or technical workflows.

Best use cases:
- object generation
- scene setup
- animation systems
- camera positioning
- procedural duplication
- material assignment

Automation improves:
- speed
- consistency
- scalability

---

## 2. Use Blender’s Python API Correctly

Most workflows rely on:
- `bpy`
- scene context
- object manipulation
- procedural logic

Common operations:
- object creation
- mesh modification
- animation keyframes
- material setup
- rendering configuration

Claude should generate:
- clean
- readable
- modular
- editable scripts

---

## 3. Keep Scripts Modular

Large Blender scripts should remain:
- organized
- reusable
- easy to debug

Preferred structure:
- setup functions
- object generators
- animation systems
- render configuration blocks

Avoid:
- giant monolithic scripts
- duplicated logic
- hardcoded scene values

---

## 4. Combine Scripting With Procedural Thinking

Good Blender scripting workflows often combine:
- Python automation
- Geometry Nodes
- procedural materials
- reusable systems

Claude should encourage:
- scalable scene generation
- editable parameters
- procedural experimentation

---

## 5. Validate Scenes Incrementally

Procedural Blender scripts can fail quickly if too many systems are generated at once.

Claud