# chenjackle45/html-visualizer architecture

> Architecture diagram of the GitHub repository chenjackle45/html-visualizer, 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/chenjackle45/html-visualizer
- Repository: https://github.com/chenjackle45/html-visualizer

## Overview

html-visualizer is a set of AI-agent skills for turning long answers into standalone, readable HTML pages, with charting and diagram-design capabilities. The documented workflow is conversational request → choose a layout and generate a page → stamp and verify it → open and archive it. The README documents the skill-level integrations; sampled sources show the verification/stamping implementation. Other skill internals were not sampled, so their detailed call relationships are not inferred.

Main entry points: [`skills/html-visualizer`](https://github.com/chenjackle45/html-visualizer/tree/main/skills/html-visualizer) (HTML visualizer), [`skills/html-visualizer/scripts/verify.py`](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/verify.py) (Page verification), [`skills/diagram-design`](https://github.com/chenjackle45/html-visualizer/tree/main/skills/diagram-design) (Diagram design), [`skills/chart`](https://github.com/chenjackle45/html-visualizer/tree/main/skills/chart) (Chart skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Page authoring"]
  node_main_skill["HTML visualizer"]
  node_layout["Layout selection<br/>[SKILL.md]"]
  node_html_page["HTML page"]
end

subgraph group_visuals["Visual content"]
  node_chart_skill["Chart skill"]
  node_chart_templates["Chart templates"]
  node_diagram_skill["Diagram design"]
  node_mermaid_import["Mermaid import<br/>[mermaid_extract.py]"]
  node_drawio_import["draw.io import<br/>[drawio_extract.py]"]
end

subgraph group_quality["Personalization and checks"]
  node_profile[("User profile<br/>[profile.py]")]
  node_verify["Page verification<br/>[verify.py]"]
  node_stamp["Page stamping<br/>[stamp.py]"]
  node_layout_check["Layout check<br/>[layout-check.mjs]"]
  node_runtime_check["Runtime check<br/>[runtime-check.mjs]"]
  node_scale_check["Scale check<br/>[scale-check.mjs]"]
  node_svg_check["SVG text check<br/>[svg-text-check.mjs]"]
  node_diagram_check["Diagram check<br/>[self_check.py]"]
end

subgraph group_archive["Access and archive"]
  node_archive[("HTML archive")]
  node_index["Archive index<br/>[reindex.py]"]
end

node_user(("User"))
node_agent(("AI agent"))

node_user -->|"requests page"| node_agent
node_agent -->|"invokes skill"| node_main_skill
node_main_skill -->|"chooses layout"| node_layout
node_main_skill -->|"generates page"| node_html_page
node_main_skill -.->|"uses charts"| node_chart_skill
node_chart_skill -.->|"uses templates"| node_chart_templates
node_main_skill -.->|"uses diagrams"| node_diagram_skill
node_diagram_skill -.->|"imports Mermaid"| node_mermaid_import
node_diagram_skill -.->|"imports draw.io"| node_drawio_import
node_main_skill -->|"checks page"| node_verify
node_verify -->|"stamps first"| node_stamp
node_verify -->|"loads settings"| node_profile
node_verify -.->|"checks layout"| node_layout_check
node_verify -.->|"checks behavior"| node_runtime_check
node_verify -.->|"checks scaling"| node_scale_check
node_verify -.->|"checks SVG"| node_svg_check
node_diagram_skill -.->|"checks diagrams"| node_diagram_check
node_main_skill -.->|"opens page"| node_html_page
node_main_skill -.->|"saves page"| node_archive
node_archive -.->|"indexes pages"| node_index
node_index -.->|"offers lookup"| node_user

click node_main_skill "https://github.com/chenjackle45/html-visualizer/tree/main/skills/html-visualizer"
click node_layout "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/SKILL.md"
click node_chart_skill "https://github.com/chenjackle45/html-visualizer/tree/main/skills/chart"
click node_chart_templates "https://github.com/chenjackle45/html-visualizer/tree/main/skills/chart/templates"
click node_diagram_skill "https://github.com/chenjackle45/html-visualizer/tree/main/skills/diagram-design"
click node_mermaid_import "https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/mermaid_extract.py"
click node_drawio_import "https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/drawio_extract.py"
click node_profile "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/profile.py"
click node_verify "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/verify.py"
click node_stamp "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/stamp.py"
click node_layout_check "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/layout-check.mjs"
click node_runtime_check "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/runtime-check.mjs"
click node_scale_check "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/scale-check.mjs"
click node_svg_check "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/svg-text-check.mjs"
click node_diagram_check "https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/self_check.py"
click node_index "https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/reindex.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_main_skill,node_layout,node_html_page,node_user toneBlue
class node_chart_skill,node_chart_templates,node_diagram_skill,node_mermaid_import,node_drawio_import toneAmber
class node_profile,node_verify,node_stamp,node_layout_check,node_runtime_check,node_scale_check,node_svg_check,node_diagram_check toneMint
class node_archive,node_index toneRose
class node_agent toneIndigo
```

## Components

### Page authoring

- [HTML visualizer](https://github.com/chenjackle45/html-visualizer/tree/main/skills/html-visualizer): `skills/html-visualizer`
- [Layout selection](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/SKILL.md): `skills/html-visualizer/SKILL.md`
- **HTML page**

### Visual content

- [Chart skill](https://github.com/chenjackle45/html-visualizer/tree/main/skills/chart): `skills/chart`
- [Chart templates](https://github.com/chenjackle45/html-visualizer/tree/main/skills/chart/templates): `skills/chart/templates`
- [Diagram design](https://github.com/chenjackle45/html-visualizer/tree/main/skills/diagram-design): `skills/diagram-design`
- [Mermaid import](https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/mermaid_extract.py): `skills/diagram-design/scripts/mermaid_extract.py`
- [draw.io import](https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/drawio_extract.py): `skills/diagram-design/scripts/drawio_extract.py`

### Personalization and checks

- [User profile](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/profile.py): `skills/html-visualizer/scripts/profile.py`
- [Page verification](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/verify.py): `skills/html-visualizer/scripts/verify.py`
- [Page stamping](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/stamp.py): `skills/html-visualizer/scripts/stamp.py`
- [Layout check](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/layout-check.mjs): `skills/html-visualizer/scripts/layout-check.mjs`
- [Runtime check](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/runtime-check.mjs): `skills/html-visualizer/scripts/runtime-check.mjs`
- [Scale check](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/scale-check.mjs): `skills/html-visualizer/scripts/scale-check.mjs`
- [SVG text check](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/svg-text-check.mjs): `skills/html-visualizer/scripts/svg-text-check.mjs`
- [Diagram check](https://github.com/chenjackle45/html-visualizer/blob/main/skills/diagram-design/scripts/self_check.py): `skills/diagram-design/scripts/self_check.py`

### Access and archive

- **HTML archive**
- [Archive index](https://github.com/chenjackle45/html-visualizer/blob/main/skills/html-visualizer/scripts/reindex.py): `skills/html-visualizer/scripts/reindex.py`

### Other components

- **User**
- **AI agent**

## Connections

- User → AI agent: requests page (evidence: `README.md`)
- AI agent → HTML visualizer: invokes skill (evidence: `README.md`)
- HTML visualizer → Layout selection: chooses layout (evidence: `README.md`)
- HTML visualizer → HTML page: generates page (evidence: `README.md`)
- HTML visualizer → Chart skill: uses charts (evidence: `README.md`)
- Chart skill → Chart templates: uses templates (evidence: `README.md`)
- HTML visualizer → Diagram design: uses diagrams (evidence: `README.md`)
- Diagram design → Mermaid import: imports Mermaid (evidence: `README.md`)
- Diagram design → draw.io import: imports draw.io (evidence: `README.md`)
- HTML visualizer → Page verification: checks page (evidence: `README.md`)
- Page verification → Page stamping: stamps first (evidence: `skills/html-visualizer/scripts/verify.py`)
- Page verification → User profile: loads settings (evidence: `skills/html-visualizer/scripts/verify.py`)
- Page verification → Layout check: checks layout (evidence: `README.md`)
- Page verification → Runtime check: checks behavior (evidence: `README.md`)
- Page verification → Scale check: checks scaling (evidence: `README.md`)
- Page verification → SVG text check: checks SVG (evidence: `README.md`)
- Diagram design → Diagram check: checks diagrams (evidence: `README.md`)
- HTML visualizer → HTML page: opens page (evidence: `README.md`)
- HTML visualizer → HTML archive: saves page (evidence: `README.md`)
- HTML archive → Archive index: indexes pages (evidence: `README.md`)
- Archive index → User: offers lookup (evidence: `README.md`)
