# el4cteo/blender-skills architecture

> Architecture diagram of the GitHub repository el4cteo/blender-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/el4cteo/blender-skills
- Repository: https://github.com/el4cteo/blender-skills

## Overview

Blender Agent Skills is a collection of agent-invoked Blender workflows, not a single asset-processing pipeline. An agent selects a skill and runs its script in Blender; the scripts create or inspect scene data and return results. The README documents the product’s broad 3D-pipeline capabilities, while the sampled shared helper supports common script/CLI behavior. Source-index references establish several script-to-helper links; most cross-skill sequencing is not evidenced, so the graph keeps skills independent. Many skill implementations were not sampled.

Main entry points: [`shared/_bpyx.py`](https://github.com/el4cteo/blender-skills/blob/main/shared/_bpyx.py) (Shared helpers), [`skills/blender-core/scripts/run_in_blender.py`](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-core/scripts/run_in_blender.py) (Blender runner), [`skills/blender-environment-kits/scripts/scatter.py`](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-environment-kits/scripts/scatter.py) (Environment kits), [`skills/blender-pbr-materials/scripts/build_pbr_material.py`](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-pbr-materials/scripts/build_pbr_material.py) (PBR materials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core runtime"]
  node_runner["Blender runner<br/>[run_in_blender.py]"]
  node_helpers["Shared helpers<br/>[_bpyx.py]"]
end

subgraph group_model["Modeling and assets"]
  node_hard_surface["Hard-surface modeling<br/>[apply_stack.py]"]
  node_sculpting["Sculpting<br/>[sculpt_ops.py]"]
  node_geometry_nodes["Geometry nodes<br/>[gn_builder.py]"]
  node_retopo_uv["Retopology and UV<br/>[uv_pack.py]"]
  node_environment_kits["Environment kits<br/>[scatter.py]"]
end

subgraph group_look["Materials and look"]
  node_pbr["PBR materials"]
  node_texturing["Smart texturing<br/>[smart_material.py]"]
  node_baking["Texture baking<br/>[bake_maps.py]"]
  node_toon["Stylized shading<br/>[toon_setup.py]"]
end

subgraph group_character["Characters and motion"]
  node_rigging["Character rigging<br/>[bind_mesh.py]"]
  node_facial["Facial shapekeys<br/>[shapekeys.py]"]
  node_clothing["Clothing<br/>[garment.py]"]
  node_hair["Hair grooming<br/>[groom.py]"]
  node_animation["Animation<br/>[retarget.py]"]
end

subgraph group_scene["Scene and delivery"]
  node_scene_setup["Scene setup<br/>[scene_audit.py]"]
  node_simulation["Simulation<br/>[sim_setup.py]"]
  node_weather["Weather effects<br/>[precipitation.py]"]
  node_time_mood["Time and mood<br/>[scene_mood.py]"]
  node_lighting["Lighting and lookdev<br/>[turntable.py]"]
  node_rendering["Rendering<br/>[render_batch.py]"]
  node_video["Video editing<br/>[vse_edit.py]"]
  node_optimization["Game optimization<br/>[make_lods.py]"]
  node_export["Asset export<br/>[export_asset.py]"]
  node_automation["Pipeline automation<br/>[batch_process.py]"]
  node_qa["Asset QA<br/>[qa_check.py]"]
end

node_agent(("AI agent"))
node_blender(("Blender"))

node_agent -.->|"runs scripts"| node_runner
node_runner -.->|"executes in"| node_blender
node_agent -.->|"invokes skill"| node_scene_setup
node_agent -.->|"invokes skill"| node_hard_surface
node_agent -.->|"invokes skill"| node_sculpting
node_agent -.->|"invokes skill"| node_geometry_nodes
node_agent -.->|"invokes skill"| node_retopo_uv
node_agent -.->|"invokes skill"| node_environment_kits
node_agent -.->|"invokes skill"| node_pbr
node_agent -.->|"invokes skill"| node_texturing
node_agent -.->|"invokes skill"| node_baking
node_agent -.->|"invokes skill"| node_toon
node_agent -.->|"invokes skill"| node_rigging
node_agent -.->|"invokes skill"| node_facial
node_agent -.->|"invokes skill"| node_clothing
node_agent -.->|"invokes skill"| node_hair
node_agent -.->|"invokes skill"| node_animation
node_agent -.->|"invokes skill"| node_simulation
node_agent -.->|"invokes skill"| node_weather
node_agent -.->|"invokes skill"| node_time_mood
node_agent -.->|"invokes skill"| node_lighting
node_agent -.->|"invokes skill"| node_rendering
node_agent -.->|"invokes skill"| node_video
node_agent -.->|"invokes skill"| node_optimization
node_agent -.->|"invokes skill"| node_export
node_agent -.->|"invokes skill"| node_automation
node_agent -.->|"invokes skill"| node_qa
node_qa -->|"uses helpers"| node_helpers
node_rigging -->|"uses helpers"| node_helpers
node_clothing -->|"uses helpers"| node_helpers
node_environment_kits -->|"uses helpers"| node_helpers
node_pbr -->|"uses helpers"| node_helpers
node_baking -->|"uses helpers"| node_helpers
node_toon -->|"uses helpers"| node_helpers
node_weather -->|"uses helpers"| node_helpers
node_time_mood -->|"uses helpers"| node_helpers

click node_runner "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-core/scripts/run_in_blender.py"
click node_helpers "https://github.com/el4cteo/blender-skills/blob/main/shared/_bpyx.py"
click node_scene_setup "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-scene-setup/scripts/scene_audit.py"
click node_hard_surface "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-hardsurface-modeling/scripts/apply_stack.py"
click node_sculpting "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-sculpting/scripts/sculpt_ops.py"
click node_geometry_nodes "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-geometry-nodes/scripts/gn_builder.py"
click node_retopo_uv "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-retopology-uv/scripts/uv_pack.py"
click node_environment_kits "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-environment-kits/scripts/scatter.py"
click node_pbr "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-pbr-materials/scripts/build_pbr_material.py"
click node_texturing "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-texturing/scripts/smart_material.py"
click node_baking "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-texture-baking/scripts/bake_maps.py"
click node_toon "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-stylized-npr/scripts/toon_setup.py"
click node_rigging "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-character-rigging/scripts/bind_mesh.py"
click node_facial "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-facial-shapekeys/scripts/shapekeys.py"
click node_clothing "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-clothing/scripts/garment.py"
click node_hair "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-hair-grooming/scripts/groom.py"
click node_animation "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-animation/scripts/retarget.py"
click node_simulation "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-simulation/scripts/sim_setup.py"
click node_weather "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-weather-fx/scripts/precipitation.py"
click node_time_mood "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-time-of-day/scripts/scene_mood.py"
click node_lighting "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-lighting-lookdev/scripts/turntable.py"
click node_rendering "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-rendering/scripts/render_batch.py"
click node_video "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-video-editing/scripts/vse_edit.py"
click node_optimization "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-game-optimization/scripts/make_lods.py"
click node_export "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-export-pipelines/scripts/export_asset.py"
click node_automation "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-pipeline-automation/scripts/batch_process.py"
click node_qa "https://github.com/el4cteo/blender-skills/blob/main/skills/blender-asset-qa/scripts/qa_check.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_helpers toneBlue
class node_hard_surface,node_sculpting,node_geometry_nodes,node_retopo_uv,node_environment_kits toneAmber
class node_pbr,node_texturing,node_baking,node_toon toneMint
class node_rigging,node_facial,node_clothing,node_hair,node_animation toneRose
class node_scene_setup,node_simulation,node_weather,node_time_mood,node_lighting,node_rendering,node_video,node_optimization,node_export,node_automation,node_qa,node_agent,node_blender toneIndigo
```

## Components

### Core runtime

- [Blender runner](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-core/scripts/run_in_blender.py): `skills/blender-core/scripts/run_in_blender.py`
- [Shared helpers](https://github.com/el4cteo/blender-skills/blob/main/shared/_bpyx.py): `shared/_bpyx.py`

### Modeling and assets

- [Hard-surface modeling](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-hardsurface-modeling/scripts/apply_stack.py): `skills/blender-hardsurface-modeling/scripts/apply_stack.py`
- [Sculpting](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-sculpting/scripts/sculpt_ops.py): `skills/blender-sculpting/scripts/sculpt_ops.py`
- [Geometry nodes](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-geometry-nodes/scripts/gn_builder.py): `skills/blender-geometry-nodes/scripts/gn_builder.py`
- [Retopology and UV](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-retopology-uv/scripts/uv_pack.py): `skills/blender-retopology-uv/scripts/uv_pack.py`
- [Environment kits](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-environment-kits/scripts/scatter.py): `skills/blender-environment-kits/scripts/scatter.py`

### Materials and look

- [PBR materials](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-pbr-materials/scripts/build_pbr_material.py): `skills/blender-pbr-materials/scripts/build_pbr_material.py`
- [Smart texturing](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-texturing/scripts/smart_material.py): `skills/blender-texturing/scripts/smart_material.py`
- [Texture baking](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-texture-baking/scripts/bake_maps.py): `skills/blender-texture-baking/scripts/bake_maps.py`
- [Stylized shading](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-stylized-npr/scripts/toon_setup.py): `skills/blender-stylized-npr/scripts/toon_setup.py`

### Characters and motion

- [Character rigging](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-character-rigging/scripts/bind_mesh.py): `skills/blender-character-rigging/scripts/bind_mesh.py`
- [Facial shapekeys](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-facial-shapekeys/scripts/shapekeys.py): `skills/blender-facial-shapekeys/scripts/shapekeys.py`
- [Clothing](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-clothing/scripts/garment.py): `skills/blender-clothing/scripts/garment.py`
- [Hair grooming](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-hair-grooming/scripts/groom.py): `skills/blender-hair-grooming/scripts/groom.py`
- [Animation](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-animation/scripts/retarget.py): `skills/blender-animation/scripts/retarget.py`

### Scene and delivery

- [Scene setup](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-scene-setup/scripts/scene_audit.py): `skills/blender-scene-setup/scripts/scene_audit.py`
- [Simulation](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-simulation/scripts/sim_setup.py): `skills/blender-simulation/scripts/sim_setup.py`
- [Weather effects](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-weather-fx/scripts/precipitation.py): `skills/blender-weather-fx/scripts/precipitation.py`
- [Time and mood](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-time-of-day/scripts/scene_mood.py): `skills/blender-time-of-day/scripts/scene_mood.py`
- [Lighting and lookdev](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-lighting-lookdev/scripts/turntable.py): `skills/blender-lighting-lookdev/scripts/turntable.py`
- [Rendering](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-rendering/scripts/render_batch.py): `skills/blender-rendering/scripts/render_batch.py`
- [Video editing](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-video-editing/scripts/vse_edit.py): `skills/blender-video-editing/scripts/vse_edit.py`
- [Game optimization](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-game-optimization/scripts/make_lods.py): `skills/blender-game-optimization/scripts/make_lods.py`
- [Asset export](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-export-pipelines/scripts/export_asset.py): `skills/blender-export-pipelines/scripts/export_asset.py`
- [Pipeline automation](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-pipeline-automation/scripts/batch_process.py): `skills/blender-pipeline-automation/scripts/batch_process.py`
- [Asset QA](https://github.com/el4cteo/blender-skills/blob/main/skills/blender-asset-qa/scripts/qa_check.py): `skills/blender-asset-qa/scripts/qa_check.py`

### Other components

- **AI agent**
- **Blender**

## Connections

- AI agent → Blender runner: runs scripts (evidence: `README.md`)
- Blender runner → Blender: executes in (evidence: `README.md`)
- AI agent → Scene setup: invokes skill (evidence: `README.md`)
- AI agent → Hard-surface modeling: invokes skill (evidence: `README.md`)
- AI agent → Sculpting: invokes skill (evidence: `README.md`)
- AI agent → Geometry nodes: invokes skill (evidence: `README.md`)
- AI agent → Retopology and UV: invokes skill (evidence: `README.md`)
- AI agent → Environment kits: invokes skill (evidence: `README.md`)
- AI agent → PBR materials: invokes skill (evidence: `README.md`)
- AI agent → Smart texturing: invokes skill (evidence: `README.md`)
- AI agent → Texture baking: invokes skill (evidence: `README.md`)
- AI agent → Stylized shading: invokes skill (evidence: `README.md`)
- AI agent → Character rigging: invokes skill (evidence: `README.md`)
- AI agent → Facial shapekeys: invokes skill (evidence: `README.md`)
- AI agent → Clothing: invokes skill (evidence: `README.md`)
- AI agent → Hair grooming: invokes skill (evidence: `README.md`)
- AI agent → Animation: invokes skill (evidence: `README.md`)
- AI agent → Simulation: invokes skill (evidence: `README.md`)
- AI agent → Weather effects: invokes skill (evidence: `README.md`)
- AI agent → Time and mood: invokes skill (evidence: `README.md`)
- AI agent → Lighting and lookdev: invokes skill (evidence: `README.md`)
- AI agent → Rendering: invokes skill (evidence: `README.md`)
- AI agent → Video editing: invokes skill (evidence: `README.md`)
- AI agent → Game optimization: invokes skill (evidence: `README.md`)
- AI agent → Asset export: invokes skill (evidence: `README.md`)
- AI agent → Pipeline automation: invokes skill (evidence: `README.md`)
- AI agent → Asset QA: invokes skill (evidence: `README.md`)
- Asset QA → Shared helpers: uses helpers (evidence: `skills/blender-asset-qa/scripts/qa_check.py`)
- Character rigging → Shared helpers: uses helpers (evidence: `skills/blender-character-rigging/scripts/bind_mesh.py`)
- Clothing → Shared helpers: uses helpers (evidence: `skills/blender-clothing/scripts/garment.py`)
- Environment kits → Shared helpers: uses helpers (evidence: `skills/blender-environment-kits/scripts/scatter.py`)
- PBR materials → Shared helpers: uses helpers (evidence: `skills/blender-pbr-materials/scripts/build_pbr_material.py`)
- Texture baking → Shared helpers: uses helpers (evidence: `skills/blender-texture-baking/scripts/bake_maps.py`)
- Stylized shading → Shared helpers: uses helpers (evidence: `skills/blender-stylized-npr/scripts/toon_setup.py`)
- Weather effects → Shared helpers: uses helpers (evidence: `skills/blender-weather-fx/scripts/precipitation.py`)
- Time and mood → Shared helpers: uses helpers (evidence: `skills/blender-time-of-day/scripts/scene_mood.py`)
