# arjun988/blender-skills architecture

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

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

## Overview

Blender Skills is a local skill pack and documentation site that guides AI coding assistants through Blender technical-art work, with Blender MCP as the documented execution bridge. The primary workflow is an artist’s request, director-led skill selection, discipline-specific production and style guidance, then optimization, QA, and engine export; its documented branches also include reference-image matching and domain-specific packs. Repository evidence for the skills is mostly README-level, so the graph shows those capabilities without asserting unsampled internal calls. The sampled website provides discovery and setup information, not the Blender runtime itself.

Main entry points: [`.claude/skills/blender-director`](https://github.com/arjun988/blender-skills/tree/main/.claude/skills/blender-director) (Skill Director), [`site/src/lib/skills-data.ts`](https://github.com/arjun988/blender-skills/blob/main/site/src/lib/skills-data.ts) (Skill Metadata), [`site/src/app/page.tsx`](https://github.com/arjun988/blender-skills/blob/main/site/src/app/page.tsx) (Home Page), [`site/src/app/(docs)/skills/page.tsx`](https://github.com/arjun988/blender-skills/blob/main/site/src/app/(docs)/skills/page.tsx) (Skills Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Website Discovery"]
  node_homepage["Home Page<br/>[page.tsx]"]
  node_catalog["Skills Catalog<br/>[page.tsx]"]
  node_gettingstarted["Setup Guide<br/>[page.tsx]"]
  node_skilldata["Skill Metadata<br/>[skills-data.ts]"]
end

subgraph group_skillpack["Skill Guidance"]
  node_director["Skill Director<br/>[blender-director]"]
  node_styling["Style &amp; World Packs<br/>[skills]"]
  node_genre["Genre Direction<br/>[skills]"]
end

subgraph group_production["Asset Production"]
  node_modeling["Modeling Skills<br/>[skills]"]
  node_productionguides["Production Skills<br/>[skills]"]
  node_reference["Reference Matching"]
  node_scene["Scene &amp; Set Dressing<br/>[skills]"]
  node_technical["Technical Art<br/>[skills]"]
end

subgraph group_delivery["Validation &amp; Delivery"]
  node_optimization["Asset Optimization<br/>[asset-optimization]"]
  node_qa["QA Review<br/>[qa-review]"]
  node_export["Engine Export<br/>[export-pipeline]"]
end

subgraph group_execution["Agent Execution"]
  node_agent(("AI Assistant"))
  node_skillfiles["Installed Skills<br/>[skills]"]
  node_blender["Blender MCP"]
  node_blenderapp["Blender"]
end

node_artist(("Artist"))

node_artist -->|"explores"| node_homepage
node_artist -->|"browses"| node_catalog
node_artist -->|"follows setup"| node_gettingstarted
node_homepage -->|"reads metadata"| node_skilldata
node_catalog -->|"reads metadata"| node_skilldata
node_gettingstarted -->|"reads metadata"| node_skilldata
node_artist -.->|"requests work"| node_agent
node_agent -->|"routes request"| node_director
node_director -->|"selects skills"| node_modeling
node_director -->|"selects skills"| node_productionguides
node_director -->|"selects packs"| node_styling
node_director -->|"selects direction"| node_genre
node_director -->|"routes match"| node_reference
node_director -.->|"routes work"| node_scene
node_director -.->|"routes work"| node_technical
node_director -->|"routes validation"| node_optimization
node_director -->|"routes review"| node_qa
node_director -->|"routes delivery"| node_export
node_agent -->|"loads skills"| node_skillfiles
node_skillfiles -->|"executes through"| node_blender
node_blender -->|"controls"| node_blenderapp

click node_homepage "https://github.com/arjun988/blender-skills/blob/main/site/src/app/page.tsx"
click node_catalog "https://github.com/arjun988/blender-skills/blob/main/site/src/app/(docs)/skills/page.tsx"
click node_gettingstarted "https://github.com/arjun988/blender-skills/blob/main/site/src/app/(docs)/getting-started/page.tsx"
click node_skilldata "https://github.com/arjun988/blender-skills/blob/main/site/src/lib/skills-data.ts"
click node_director "https://github.com/arjun988/blender-skills/tree/main/.claude/skills/blender-director"
click node_modeling "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_productionguides "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_styling "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_genre "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_reference "https://github.com/arjun988/blender-skills/blob/main/.claude/skills/references/reference-image-match.md"
click node_scene "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_technical "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"
click node_optimization "https://github.com/arjun988/blender-skills/tree/main/.claude/skills/asset-optimization"
click node_qa "https://github.com/arjun988/blender-skills/tree/main/.claude/skills/qa-review"
click node_export "https://github.com/arjun988/blender-skills/tree/main/.claude/skills/export-pipeline"
click node_skillfiles "https://github.com/arjun988/blender-skills/tree/main/.claude/skills"

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_homepage,node_catalog,node_gettingstarted,node_skilldata toneBlue
class node_director,node_styling,node_genre toneAmber
class node_modeling,node_productionguides,node_reference,node_scene,node_technical toneMint
class node_optimization,node_qa,node_export toneRose
class node_agent,node_skillfiles,node_blender,node_blenderapp,node_artist toneIndigo
```

## Components

### Website Discovery

- [Home Page](https://github.com/arjun988/blender-skills/blob/main/site/src/app/page.tsx): `site/src/app/page.tsx`
- [Skills Catalog](https://github.com/arjun988/blender-skills/blob/main/site/src/app/(docs)/skills/page.tsx): `site/src/app/(docs)/skills/page.tsx`
- [Setup Guide](https://github.com/arjun988/blender-skills/blob/main/site/src/app/(docs)/getting-started/page.tsx): `site/src/app/(docs)/getting-started/page.tsx`
- [Skill Metadata](https://github.com/arjun988/blender-skills/blob/main/site/src/lib/skills-data.ts): `site/src/lib/skills-data.ts`

### Skill Guidance

- [Skill Director](https://github.com/arjun988/blender-skills/tree/main/.claude/skills/blender-director): `.claude/skills/blender-director`
- [Style & World Packs](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`
- [Genre Direction](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`

### Asset Production

- [Modeling Skills](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`
- [Production Skills](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`
- [Reference Matching](https://github.com/arjun988/blender-skills/blob/main/.claude/skills/references/reference-image-match.md): `.claude/skills/references/reference-image-match.md`
- [Scene & Set Dressing](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`
- [Technical Art](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`

### Validation & Delivery

- [Asset Optimization](https://github.com/arjun988/blender-skills/tree/main/.claude/skills/asset-optimization): `.claude/skills/asset-optimization`
- [QA Review](https://github.com/arjun988/blender-skills/tree/main/.claude/skills/qa-review): `.claude/skills/qa-review`
- [Engine Export](https://github.com/arjun988/blender-skills/tree/main/.claude/skills/export-pipeline): `.claude/skills/export-pipeline`

### Agent Execution

- **AI Assistant**
- [Installed Skills](https://github.com/arjun988/blender-skills/tree/main/.claude/skills): `.claude/skills`
- **Blender MCP**
- **Blender**

### Other components

- **Artist**

## Connections

- Artist → Home Page: explores (evidence: `site/src/app/page.tsx`)
- Artist → Skills Catalog: browses (evidence: `site/src/app/(docs)/skills/page.tsx`)
- Artist → Setup Guide: follows setup (evidence: `site/src/app/(docs)/getting-started/page.tsx`)
- Home Page → Skill Metadata: reads metadata (evidence: `site/src/app/page.tsx`)
- Skills Catalog → Skill Metadata: reads metadata (evidence: `site/src/app/(docs)/skills/page.tsx`)
- Setup Guide → Skill Metadata: reads metadata (evidence: `site/src/app/(docs)/getting-started/page.tsx`)
- Artist → AI Assistant: requests work (evidence: `README.md`)
- AI Assistant → Skill Director: routes request (evidence: `README.md`)
- Skill Director → Modeling Skills: selects skills (evidence: `README.md`)
- Skill Director → Production Skills: selects skills (evidence: `README.md`)
- Skill Director → Style & World Packs: selects packs (evidence: `README.md`)
- Skill Director → Genre Direction: selects direction (evidence: `README.md`)
- Skill Director → Reference Matching: routes match (evidence: `README.md`)
- Skill Director → Scene & Set Dressing: routes work
- Skill Director → Technical Art: routes work
- Skill Director → Asset Optimization: routes validation (evidence: `README.md`)
- Skill Director → QA Review: routes review (evidence: `README.md`)
- Skill Director → Engine Export: routes delivery (evidence: `README.md`)
- AI Assistant → Installed Skills: loads skills (evidence: `README.md`)
- Installed Skills → Blender MCP: executes through (evidence: `README.md`)
- Blender MCP → Blender: controls (evidence: `README.md`)