# majidmanzarpour/blender-game-skills architecture

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

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

## Overview

Blender Game Skills is an agent-followed Blender asset-creation skill, not a standalone application. The main workflow takes reference images and a request through measured brief and calibration, gated modelling and preparation, then export and round-trip acceptance. `SKILL.md` defines the phases and runs the supplied scripts; sampled scripts support review rendering and measurement, topology validation, map baking, export, and reimport checks. Other documented phases—such as rigging, secondary motion, and animation—are retained as skill-directed work, but their implementation wiring is not inferred from the sampled source.

Main entry points: [`skills/blender-image-to-3d/SKILL.md`](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md) (Asset workflow), [`skills/blender-image-to-3d/scripts/init_master.py`](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/init_master.py) (Calibration scene), [`skills/blender-image-to-3d/assets/build_template.py`](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/assets/build_template.py) (Asset construction), [`skills/blender-image-to-3d/scripts/review_render.py`](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/review_render.py) (Review renders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Skill guidance"]
  node_skill["Asset workflow<br/>[SKILL.md]"]
  node_brief["Brief<br/>[SKILL.md]"]
end

subgraph group_modeling["Reference modeling"]
  node_calibration["Calibration scene<br/>[init_master.py]"]
  node_build["Asset construction<br/>[build_template.py]"]
  node_blockout["Blockout and forms<br/>[SKILL.md]"]
  node_review_render["Review renders<br/>[review_render.py]"]
  node_compose["Compare measurements<br/>[compose_review.py]"]
  node_world_gate["World-space gate<br/>[world_gate.py]"]
end

subgraph group_prep["Asset preparation"]
  node_topology["Topology and LODs<br/>[SKILL.md]"]
  node_validate["Mesh validation<br/>[validate.py]"]
  node_uv_bake["UVs and baking<br/>[bake_maps.py]"]
  node_rig_motion["Rig and motion<br/>[SKILL.md]"]
  node_animation["Animation clips<br/>[SKILL.md]"]
end

subgraph group_delivery["Delivery checks"]
  node_export["Export package<br/>[export_delivery.py]"]
  node_roundtrip["Reimport checks<br/>[roundtrip.py]"]
  node_acceptance["Acceptance gate"]
end

node_requester(("User / agent"))
node_references["Reference images"]

node_requester -->|"requests asset"| node_skill
node_references -->|"inform brief"| node_brief
node_skill -->|"guides"| node_brief
node_skill -->|"directs setup"| node_calibration
node_brief -->|"sets scale"| node_calibration
node_calibration -->|"provides scene"| node_build
node_skill -->|"guides phases"| node_blockout
node_build -->|"constructs forms"| node_blockout
node_skill -->|"requests renders"| node_review_render
node_review_render -->|"supplies render"| node_compose
node_references -->|"supplies image"| node_compose
node_skill -->|"runs gate"| node_world_gate
node_skill -->|"guides phase"| node_topology
node_skill -->|"runs checks"| node_validate
node_skill -->|"runs baking"| node_uv_bake
node_skill -->|"guides phase"| node_rig_motion
node_skill -->|"guides phase"| node_animation
node_skill -->|"runs export"| node_export
node_export -->|"produces asset"| node_roundtrip
node_roundtrip -->|"reports checks"| node_acceptance
node_skill -->|"requires evidence"| node_acceptance

click node_skill "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_brief "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_calibration "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/init_master.py"
click node_build "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/assets/build_template.py"
click node_blockout "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_review_render "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/review_render.py"
click node_compose "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/compose_review.py"
click node_world_gate "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/world_gate.py"
click node_topology "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_validate "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/validate.py"
click node_uv_bake "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/bake_maps.py"
click node_rig_motion "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_animation "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md"
click node_export "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/export_delivery.py"
click node_roundtrip "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/roundtrip.py"
click node_acceptance "https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/references/delivery-and-acceptance.md"

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_skill,node_brief,node_requester toneBlue
class node_calibration,node_build,node_blockout,node_review_render,node_compose,node_world_gate toneAmber
class node_topology,node_validate,node_uv_bake,node_rig_motion,node_animation toneMint
class node_export,node_roundtrip,node_acceptance toneRose
class node_references toneIndigo
```

## Components

### Skill guidance

- [Asset workflow](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`
- [Brief](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`

### Reference modeling

- [Calibration scene](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/init_master.py): `skills/blender-image-to-3d/scripts/init_master.py`
- [Asset construction](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/assets/build_template.py): `skills/blender-image-to-3d/assets/build_template.py`
- [Blockout and forms](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`
- [Review renders](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/review_render.py): `skills/blender-image-to-3d/scripts/review_render.py`
- [Compare measurements](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/compose_review.py): `skills/blender-image-to-3d/scripts/compose_review.py`
- [World-space gate](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/world_gate.py): `skills/blender-image-to-3d/scripts/world_gate.py`

### Asset preparation

- [Topology and LODs](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`
- [Mesh validation](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/validate.py): `skills/blender-image-to-3d/scripts/validate.py`
- [UVs and baking](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/bake_maps.py): `skills/blender-image-to-3d/scripts/bake_maps.py`
- [Rig and motion](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`
- [Animation clips](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/SKILL.md): `skills/blender-image-to-3d/SKILL.md`

### Delivery checks

- [Export package](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/export_delivery.py): `skills/blender-image-to-3d/scripts/export_delivery.py`
- [Reimport checks](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/scripts/roundtrip.py): `skills/blender-image-to-3d/scripts/roundtrip.py`
- [Acceptance gate](https://github.com/majidmanzarpour/blender-game-skills/blob/main/skills/blender-image-to-3d/references/delivery-and-acceptance.md): `skills/blender-image-to-3d/references/delivery-and-acceptance.md`

### Other components

- **User / agent**
- **Reference images**

## Connections

- User / agent → Asset workflow: requests asset
- Reference images → Brief: inform brief
- Asset workflow → Brief: guides
- Asset workflow → Calibration scene: directs setup
- Brief → Calibration scene: sets scale
- Calibration scene → Asset construction: provides scene
- Asset workflow → Blockout and forms: guides phases
- Asset construction → Blockout and forms: constructs forms
- Asset workflow → Review renders: requests renders
- Review renders → Compare measurements: supplies render
- Reference images → Compare measurements: supplies image
- Asset workflow → World-space gate: runs gate
- Asset workflow → Topology and LODs: guides phase
- Asset workflow → Mesh validation: runs checks
- Asset workflow → UVs and baking: runs baking
- Asset workflow → Rig and motion: guides phase
- Asset workflow → Animation clips: guides phase
- Asset workflow → Export package: runs export
- Export package → Reimport checks: produces asset
- Reimport checks → Acceptance gate: reports checks
- Asset workflow → Acceptance gate: requires evidence