# ythx-101/live-panel-skill architecture

> Architecture diagram of the GitHub repository ythx-101/live-panel-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ythx-101/live-panel-skill
- Repository: https://github.com/ythx-101/live-panel-skill

## Overview

live-panel turns a JSON system description into an animated architecture visualization, delivered either as a live browser page or a rendered MP4; it is also packaged as an agent skill. The main video workflow embeds the config in the HTML template, drives deterministic frames through Chrome, and encodes them with ffmpeg. The README documents the template’s theme, element, and time-based machine capabilities, but the template source itself was not excerpted, so those internals and their wiring are shown only at the documented level.

Main entry points: [`assets/template.html`](https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html) (Diagram template), [`scripts/render.py`](https://github.com/ythx-101/live-panel-skill/blob/main/scripts/render.py) (Video renderer), [`scripts/livepanel.py`](https://github.com/ythx-101/live-panel-skill/blob/main/scripts/livepanel.py) (Page and browser helpers), [`examples`](https://github.com/ythx-101/live-panel-skill/tree/main/examples) (JSON config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Config and skill"]
  node_skill["Agent skill<br/>[SKILL.md]"]
  node_config["JSON config"]
end

subgraph group_visualization["Visual runtime"]
  node_template["Diagram template<br/>[template.html]"]
  node_canvas["Canvas and themes<br/>[template.html]"]
  node_elements["Diagram elements<br/>[template.html]"]
  node_machines["Time-based machines<br/>[template.html]"]
end

subgraph group_rendering["Rendering"]
  node_renderer["Video renderer<br/>[render.py]"]
  node_shared["Page and browser helpers<br/>[livepanel.py]"]
  node_chrome["Chrome"]
  node_ffmpeg["ffmpeg"]
end

subgraph group_delivery["Outputs"]
  node_livepage["Live web page"]
  node_video["H.264 video"]
end

node_user(("Config author"))

node_user -->|"runs render"| node_renderer
node_user -->|"edits"| node_config
node_renderer -->|"calls helpers"| node_shared
node_shared -->|"loads"| node_config
node_shared -->|"embeds config"| node_template
node_template -->|"defines"| node_canvas
node_template -->|"renders"| node_elements
node_template -->|"animates"| node_machines
node_shared -->|"drives"| node_chrome
node_renderer -->|"pipes frames"| node_ffmpeg
node_chrome -->|"opens page"| node_template
node_renderer -->|"encodes"| node_video
node_user -.->|"opens generated page"| node_livepage
node_skill -.->|"guides use"| node_user

click node_skill "https://github.com/ythx-101/live-panel-skill/blob/main/SKILL.md"
click node_config "https://github.com/ythx-101/live-panel-skill/tree/main/examples"
click node_renderer "https://github.com/ythx-101/live-panel-skill/blob/main/scripts/render.py"
click node_shared "https://github.com/ythx-101/live-panel-skill/blob/main/scripts/livepanel.py"
click node_template "https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html"
click node_canvas "https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html"
click node_elements "https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html"
click node_machines "https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html"

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_config toneBlue
class node_template,node_canvas,node_elements,node_machines toneAmber
class node_renderer,node_shared,node_chrome,node_ffmpeg toneMint
class node_livepage,node_video toneRose
class node_user toneIndigo
```

## Components

### Config and skill

- [Agent skill](https://github.com/ythx-101/live-panel-skill/blob/main/SKILL.md): `SKILL.md`
- [JSON config](https://github.com/ythx-101/live-panel-skill/tree/main/examples): `examples`

### Visual runtime

- [Diagram template](https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html): `assets/template.html`
- [Canvas and themes](https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html): `assets/template.html`
- [Diagram elements](https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html): `assets/template.html`
- [Time-based machines](https://github.com/ythx-101/live-panel-skill/blob/main/assets/template.html): `assets/template.html`

### Rendering

- [Video renderer](https://github.com/ythx-101/live-panel-skill/blob/main/scripts/render.py): `scripts/render.py`
- [Page and browser helpers](https://github.com/ythx-101/live-panel-skill/blob/main/scripts/livepanel.py): `scripts/livepanel.py`
- **Chrome**
- **ffmpeg**

### Outputs

- **Live web page**
- **H.264 video**

### Other components

- **Config author**

## Connections

- Config author → Video renderer: runs render (evidence: `README.md`)
- Config author → JSON config: edits (evidence: `README.md`)
- Video renderer → Page and browser helpers: calls helpers (evidence: `scripts/render.py`)
- Page and browser helpers → JSON config: loads (evidence: `scripts/livepanel.py`)
- Page and browser helpers → Diagram template: embeds config (evidence: `scripts/livepanel.py`)
- Diagram template → Canvas and themes: defines (evidence: `README.md`)
- Diagram template → Diagram elements: renders (evidence: `README.md`)
- Diagram template → Time-based machines: animates (evidence: `README.md`)
- Page and browser helpers → Chrome: drives (evidence: `scripts/livepanel.py`)
- Video renderer → ffmpeg: pipes frames (evidence: `scripts/render.py`)
- Chrome → Diagram template: opens page
- Video renderer → H.264 video: encodes (evidence: `scripts/render.py`)
- Config author → Live web page: opens generated page (evidence: `README.md`)
- Agent skill → Config author: guides use (evidence: `README.md`)
