# zarazhangrui/frontend-slides architecture

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

- Interactive diagram: https://gitdiagram.com/zarazhangrui/frontend-slides
- Repository: https://github.com/zarazhangrui/frontend-slides

## Overview

Frontend Slides is an agent-facing skill for creating standalone HTML presentations and converting PowerPoint decks. The user gives the agent a brief or PPTX; the skill guides content gathering, style previews and selection, then deck authoring and browser presentation. The parallel root and plugin copies support standalone and Claude Code plugin use. The README documents the workflow and optional template pack; the sampled scripts and deck-stage component confirm PPT extraction and browser navigation. Other feature links are limited to documented capabilities because their instructions were not sampled.

Main entry points: [`SKILL.md`](https://github.com/zarazhangrui/frontend-slides/blob/main/SKILL.md) (Slide Skill), [`plugins/frontend-slides/skills/frontend-slides/SKILL.md`](https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/SKILL.md) (Plugin Skill), [`scripts/extract-pptx.py`](https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/extract-pptx.py) (PPTX Extractor), [`plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py`](https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py) (Plugin PPTX Extractor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Agent Authoring"]
  node_skill["Slide Skill<br/>[SKILL.md]"]
  node_plugin_skill["Plugin Skill<br/>[SKILL.md]"]
  node_html_template["HTML Scaffold<br/>[html-template.md]"]
  node_viewport_css["Viewport Styles<br/>[viewport-base.css]"]
  node_animation_patterns["Animation Patterns"]
end

subgraph group_styles["Style Discovery"]
  node_style_presets["Safe Presets<br/>[STYLE_PRESETS.md]"]
  node_template_index["Template Index"]
  node_template_previews["Template Previews"]
  node_template_designs["Template Designs"]
end

subgraph group_conversion["PPT Conversion"]
  node_ppt_extractor["PPTX Extractor<br/>[extract-pptx.py]"]
  node_plugin_ppt_extractor["Plugin PPTX Extractor<br/>[extract-pptx.py]"]
  node_extracted_content["Extracted Content"]
end

subgraph group_presentation["Deck Presentation"]
  node_deck_stage["Deck Runtime<br/>[deck-stage.js]"]
  node_plugin_deck_stage["Plugin Deck Runtime<br/>[deck-stage.js]"]
  node_pdf_export["PDF Export<br/>[export-pdf.sh]"]
  node_deploy["Deck Deployment<br/>[deploy.sh]"]
end

node_user(("Presenter"))
node_pptx["PowerPoint File"]
node_browser(("Web Browser"))
node_html_deck["HTML Presentation"]

node_user -->|"provides brief"| node_skill
node_user -->|"provides brief"| node_plugin_skill
node_skill -->|"loads presets"| node_style_presets
node_skill -->|"shortlists styles"| node_template_index
node_skill -->|"compares previews"| node_template_previews
node_skill -->|"loads chosen design"| node_template_designs
node_skill -.->|"authors deck"| node_html_template
node_skill -->|"uses viewport styles"| node_viewport_css
node_skill -->|"uses animation guidance"| node_animation_patterns
node_plugin_skill -.->|"loads presets"| node_style_presets
node_plugin_skill -.->|"shortlists styles"| node_template_index
node_user -->|"supplies deck"| node_pptx
node_skill -->|"requests extraction"| node_ppt_extractor
node_plugin_skill -->|"requests extraction"| node_plugin_ppt_extractor
node_pptx -.->|"extracts content"| node_ppt_extractor
node_pptx -.->|"extracts content"| node_plugin_ppt_extractor
node_ppt_extractor -->|"writes JSON and assets"| node_extracted_content
node_plugin_ppt_extractor -->|"writes JSON and assets"| node_extracted_content
node_skill -->|"confirms content"| node_extracted_content
node_skill -->|"generates presentation"| node_html_deck
node_plugin_skill -->|"generates presentation"| node_html_deck
node_html_deck -->|"opens in"| node_browser
node_html_deck -.->|"uses slide controls"| node_deck_stage
node_html_deck -.->|"uses slide controls"| node_plugin_deck_stage
node_user -.->|"exports PDF"| node_pdf_export
node_user -.->|"deploys deck"| node_deploy

click node_skill "https://github.com/zarazhangrui/frontend-slides/blob/main/SKILL.md"
click node_plugin_skill "https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/SKILL.md"
click node_style_presets "https://github.com/zarazhangrui/frontend-slides/blob/main/STYLE_PRESETS.md"
click node_template_index "https://github.com/zarazhangrui/frontend-slides/blob/main/bold-template-pack/selection-index.json"
click node_template_previews "https://github.com/zarazhangrui/frontend-slides/tree/main/bold-template-pack/templates"
click node_template_designs "https://github.com/zarazhangrui/frontend-slides/tree/main/bold-template-pack/templates"
click node_html_template "https://github.com/zarazhangrui/frontend-slides/blob/main/html-template.md"
click node_viewport_css "https://github.com/zarazhangrui/frontend-slides/blob/main/viewport-base.css"
click node_animation_patterns "https://github.com/zarazhangrui/frontend-slides/blob/main/animation-patterns.md"
click node_ppt_extractor "https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/extract-pptx.py"
click node_plugin_ppt_extractor "https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py"
click node_deck_stage "https://github.com/zarazhangrui/frontend-slides/blob/main/bold-template-pack/deck-stage.js"
click node_plugin_deck_stage "https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/bold-template-pack/deck-stage.js"
click node_pdf_export "https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/export-pdf.sh"
click node_deploy "https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/deploy.sh"

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_plugin_skill,node_html_template,node_viewport_css,node_animation_patterns,node_browser toneBlue
class node_style_presets,node_template_index,node_template_previews,node_template_designs toneAmber
class node_ppt_extractor,node_plugin_ppt_extractor,node_extracted_content toneMint
class node_deck_stage,node_plugin_deck_stage,node_pdf_export,node_deploy toneRose
class node_user,node_pptx,node_html_deck toneIndigo
```

## Components

### Agent Authoring

- [Slide Skill](https://github.com/zarazhangrui/frontend-slides/blob/main/SKILL.md): `SKILL.md`
- [Plugin Skill](https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/SKILL.md): `plugins/frontend-slides/skills/frontend-slides/SKILL.md`
- [HTML Scaffold](https://github.com/zarazhangrui/frontend-slides/blob/main/html-template.md): `html-template.md`
- [Viewport Styles](https://github.com/zarazhangrui/frontend-slides/blob/main/viewport-base.css): `viewport-base.css`
- [Animation Patterns](https://github.com/zarazhangrui/frontend-slides/blob/main/animation-patterns.md): `animation-patterns.md`

### Style Discovery

- [Safe Presets](https://github.com/zarazhangrui/frontend-slides/blob/main/STYLE_PRESETS.md): `STYLE_PRESETS.md`
- [Template Index](https://github.com/zarazhangrui/frontend-slides/blob/main/bold-template-pack/selection-index.json): `bold-template-pack/selection-index.json`
- [Template Previews](https://github.com/zarazhangrui/frontend-slides/tree/main/bold-template-pack/templates): `bold-template-pack/templates`
- [Template Designs](https://github.com/zarazhangrui/frontend-slides/tree/main/bold-template-pack/templates): `bold-template-pack/templates`

### PPT Conversion

- [PPTX Extractor](https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/extract-pptx.py): `scripts/extract-pptx.py`
- [Plugin PPTX Extractor](https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py): `plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py`
- **Extracted Content**

### Deck Presentation

- [Deck Runtime](https://github.com/zarazhangrui/frontend-slides/blob/main/bold-template-pack/deck-stage.js): `bold-template-pack/deck-stage.js`
- [Plugin Deck Runtime](https://github.com/zarazhangrui/frontend-slides/blob/main/plugins/frontend-slides/skills/frontend-slides/bold-template-pack/deck-stage.js): `plugins/frontend-slides/skills/frontend-slides/bold-template-pack/deck-stage.js`
- [PDF Export](https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/export-pdf.sh): `scripts/export-pdf.sh`
- [Deck Deployment](https://github.com/zarazhangrui/frontend-slides/blob/main/scripts/deploy.sh): `scripts/deploy.sh`

### Other components

- **Presenter**
- **PowerPoint File**
- **Web Browser**
- **HTML Presentation**

## Connections

- Presenter → Slide Skill: provides brief (evidence: `README.md`)
- Presenter → Plugin Skill: provides brief (evidence: `README.md`)
- Slide Skill → Safe Presets: loads presets (evidence: `README.md`)
- Slide Skill → Template Index: shortlists styles (evidence: `README.md`)
- Slide Skill → Template Previews: compares previews (evidence: `README.md`)
- Slide Skill → Template Designs: loads chosen design (evidence: `README.md`)
- Slide Skill → HTML Scaffold: authors deck
- Slide Skill → Viewport Styles: uses viewport styles (evidence: `README.md`)
- Slide Skill → Animation Patterns: uses animation guidance (evidence: `README.md`)
- Plugin Skill → Safe Presets: loads presets
- Plugin Skill → Template Index: shortlists styles
- Presenter → PowerPoint File: supplies deck (evidence: `README.md`)
- Slide Skill → PPTX Extractor: requests extraction (evidence: `README.md`)
- Plugin Skill → Plugin PPTX Extractor: requests extraction (evidence: `README.md`)
- PowerPoint File → PPTX Extractor: extracts content
- PowerPoint File → Plugin PPTX Extractor: extracts content
- PPTX Extractor → Extracted Content: writes JSON and assets (evidence: `scripts/extract-pptx.py`)
- Plugin PPTX Extractor → Extracted Content: writes JSON and assets (evidence: `plugins/frontend-slides/skills/frontend-slides/scripts/extract-pptx.py`)
- Slide Skill → Extracted Content: confirms content (evidence: `README.md`)
- Slide Skill → HTML Presentation: generates presentation (evidence: `README.md`)
- Plugin Skill → HTML Presentation: generates presentation (evidence: `README.md`)
- HTML Presentation → Web Browser: opens in (evidence: `README.md`)
- HTML Presentation → Deck Runtime: uses slide controls
- HTML Presentation → Plugin Deck Runtime: uses slide controls
- Presenter → PDF Export: exports PDF
- Presenter → Deck Deployment: deploys deck
