# jammyfu/open-game-skills architecture

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

- Interactive diagram: https://gitdiagram.com/jammyfu/open-game-skills
- Repository: https://github.com/jammyfu/open-game-skills

## Overview

open-game-skills is an agent skill pack, not a game runtime: a user describes a game-making task, the dispatcher selects a small set of relevant skills and an engine adapter, and the agent uses those instructions to work. Its broad capability catalog spans game disciplines, asset workflows and engine adapters. A substantial internal toolset supports 2D skinning from rig and mesh preparation through weight solving, motion evaluation, review and export. The README documents the routing model and toolkit capabilities; sampled sources confirm several skin-tool relationships, but do not establish a complete end-to-end workflow.

Main entry points: [`skills/dispatcher/SKILL.md`](https://github.com/jammyfu/open-game-skills/blob/main/skills/dispatcher/SKILL.md) (Skill dispatcher), [`skills/2d/skin-weights/scripts/skinlib.py`](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/skinlib.py) (Skin geometry), [`skills/2d/skin-weights/scripts/pose_trace.py`](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/pose_trace.py) (Pose evaluation), [`skills/2d/skin-weights/scripts/export_rigc.py`](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/export_rigc.py) (Rig export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Agent routing"]
  node_dispatcher["Skill dispatcher<br/>[SKILL.md]"]
  node_pack_skill["Pack entry skill<br/>[SKILL.md]"]
  node_catalog[("Skill catalog<br/>[catalog.json]")]
end

subgraph group_capabilities["Game skills"]
  node_disciplines["Game disciplines"]
  node_asset_skills["Asset skills"]
  node_two_d_skills["2D skills"]
  node_engine_adapters["Engine adapters"]
end

subgraph group_skinning["Skinning toolkit"]
  node_rig_mesh["Mesh building<br/>[build_mesh.py]"]
  node_skin_geometry["Skin geometry<br/>[skinlib.py]"]
  node_anatomy["Anatomy measurement<br/>[measure_anatomy.py]"]
  node_weight_solver["Weight solving<br/>[solve_weights.py]"]
  node_pose_eval["Pose evaluation<br/>[pose_trace.py]"]
  node_rig_export["Rig export<br/>[export_rigc.py]"]
end

subgraph group_review["Skin review"]
  node_weight_lint["Weight lint<br/>[lint_weights.py]"]
  node_motion_qa["Motion QA<br/>[motion_qa.py]"]
  node_skin_render["Skin rendering<br/>[render_skin.py]"]
  node_skin_audit["Trace audit<br/>[audit_skin.py]"]
  node_surface_measure["Surface measurement<br/>[measure_surface.py]"]
end

node_user(("Game maker"))

node_user -->|"describes task"| node_dispatcher
node_dispatcher -->|"selects skills"| node_catalog
node_dispatcher -->|"routes to"| node_disciplines
node_dispatcher -->|"routes to"| node_asset_skills
node_dispatcher -->|"routes to"| node_two_d_skills
node_dispatcher -->|"selects adapter"| node_engine_adapters
node_pack_skill -->|"points agents to"| node_dispatcher
node_rig_mesh -->|"uses helpers"| node_skin_geometry
node_anatomy -->|"uses helpers"| node_skin_geometry
node_weight_solver -->|"uses helpers"| node_skin_geometry
node_pose_eval -->|"uses helpers"| node_skin_geometry
node_weight_lint -->|"uses helpers"| node_skin_geometry
node_motion_qa -.->|"reads trace output"| node_pose_eval
node_skin_render -.->|"reads trace output"| node_pose_eval
node_pose_eval -->|"produces compatible trace"| node_skin_audit
node_surface_measure -.->|"measures trace data"| node_skin_audit
node_rig_export -->|"uses helpers"| node_skin_geometry
node_rig_export -->|"uses evaluator"| node_pose_eval

click node_dispatcher "https://github.com/jammyfu/open-game-skills/blob/main/skills/dispatcher/SKILL.md"
click node_pack_skill "https://github.com/jammyfu/open-game-skills/blob/main/skills/SKILL.md"
click node_catalog "https://github.com/jammyfu/open-game-skills/blob/main/skills/catalog.json"
click node_disciplines "https://github.com/jammyfu/open-game-skills/tree/main/skills/disciplines"
click node_asset_skills "https://github.com/jammyfu/open-game-skills/tree/main/skills/assets"
click node_two_d_skills "https://github.com/jammyfu/open-game-skills/tree/main/skills/2d"
click node_engine_adapters "https://github.com/jammyfu/open-game-skills/tree/main/skills/engines"
click node_rig_mesh "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/build_mesh.py"
click node_skin_geometry "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/skinlib.py"
click node_anatomy "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/measure_anatomy.py"
click node_weight_solver "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/solve_weights.py"
click node_pose_eval "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/pose_trace.py"
click node_weight_lint "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/lint_weights.py"
click node_motion_qa "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/motion_qa.py"
click node_skin_render "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/render_skin.py"
click node_skin_audit "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/spine-skeletal/scripts/audit_skin.py"
click node_surface_measure "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/spine-skeletal/scripts/measure_surface.py"
click node_rig_export "https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/export_rigc.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_dispatcher,node_pack_skill,node_catalog toneBlue
class node_disciplines,node_asset_skills,node_two_d_skills,node_engine_adapters toneAmber
class node_rig_mesh,node_skin_geometry,node_anatomy,node_weight_solver,node_pose_eval,node_rig_export toneMint
class node_weight_lint,node_motion_qa,node_skin_render,node_skin_audit,node_surface_measure toneRose
class node_user toneIndigo
```

## Components

### Agent routing

- [Skill dispatcher](https://github.com/jammyfu/open-game-skills/blob/main/skills/dispatcher/SKILL.md): `skills/dispatcher/SKILL.md`
- [Pack entry skill](https://github.com/jammyfu/open-game-skills/blob/main/skills/SKILL.md): `skills/SKILL.md`
- [Skill catalog](https://github.com/jammyfu/open-game-skills/blob/main/skills/catalog.json): `skills/catalog.json`

### Game skills

- [Game disciplines](https://github.com/jammyfu/open-game-skills/tree/main/skills/disciplines): `skills/disciplines`
- [Asset skills](https://github.com/jammyfu/open-game-skills/tree/main/skills/assets): `skills/assets`
- [2D skills](https://github.com/jammyfu/open-game-skills/tree/main/skills/2d): `skills/2d`
- [Engine adapters](https://github.com/jammyfu/open-game-skills/tree/main/skills/engines): `skills/engines`

### Skinning toolkit

- [Mesh building](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/build_mesh.py): `skills/2d/skin-weights/scripts/build_mesh.py`
- [Skin geometry](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/skinlib.py): `skills/2d/skin-weights/scripts/skinlib.py`
- [Anatomy measurement](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/measure_anatomy.py): `skills/2d/skin-weights/scripts/measure_anatomy.py`
- [Weight solving](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/solve_weights.py): `skills/2d/skin-weights/scripts/solve_weights.py`
- [Pose evaluation](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/pose_trace.py): `skills/2d/skin-weights/scripts/pose_trace.py`
- [Rig export](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/export_rigc.py): `skills/2d/skin-weights/scripts/export_rigc.py`

### Skin review

- [Weight lint](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/lint_weights.py): `skills/2d/skin-weights/scripts/lint_weights.py`
- [Motion QA](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/motion_qa.py): `skills/2d/skin-weights/scripts/motion_qa.py`
- [Skin rendering](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/skin-weights/scripts/render_skin.py): `skills/2d/skin-weights/scripts/render_skin.py`
- [Trace audit](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/spine-skeletal/scripts/audit_skin.py): `skills/2d/spine-skeletal/scripts/audit_skin.py`
- [Surface measurement](https://github.com/jammyfu/open-game-skills/blob/main/skills/2d/spine-skeletal/scripts/measure_surface.py): `skills/2d/spine-skeletal/scripts/measure_surface.py`

### Other components

- **Game maker**

## Connections

- Game maker → Skill dispatcher: describes task (evidence: `README.md`)
- Skill dispatcher → Skill catalog: selects skills (evidence: `README.md`)
- Skill dispatcher → Game disciplines: routes to (evidence: `README.md`)
- Skill dispatcher → Asset skills: routes to (evidence: `README.md`)
- Skill dispatcher → 2D skills: routes to (evidence: `README.md`)
- Skill dispatcher → Engine adapters: selects adapter (evidence: `README.md`)
- Pack entry skill → Skill dispatcher: points agents to (evidence: `README.md`)
- Mesh building → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/build_mesh.py`)
- Anatomy measurement → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/measure_anatomy.py`)
- Weight solving → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/solve_weights.py`)
- Pose evaluation → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/pose_trace.py`)
- Weight lint → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/lint_weights.py`)
- Motion QA → Pose evaluation: reads trace output
- Skin rendering → Pose evaluation: reads trace output
- Pose evaluation → Trace audit: produces compatible trace (evidence: `skills/2d/skin-weights/scripts/pose_trace.py`)
- Surface measurement → Trace audit: measures trace data (evidence: `skills/2d/spine-skeletal/scripts/measure_surface.py`)
- Rig export → Skin geometry: uses helpers (evidence: `skills/2d/skin-weights/scripts/export_rigc.py`)
- Rig export → Pose evaluation: uses evaluator (evidence: `skills/2d/skin-weights/scripts/export_rigc.py`)
