# thititj/guizang-ppt-skill-en architecture

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

- Interactive diagram: https://gitdiagram.com/thititj/guizang-ppt-skill-en
- Repository: https://github.com/thititj/guizang-ppt-skill-en

## Overview

Guizang PPT Skill is an agent-facing workflow for creating single-file HTML slide decks, visuals, and social covers, with rehearsal and presenter features. The README documents the main capabilities and the tree identifies their instruction, reference, and template locations; sampled source is limited to validators, so internal wiring beyond those documented workflows is not inferred.

Main entry points: [`SKILL.md`](https://github.com/thititj/guizang-ppt-skill-en/blob/main/SKILL.md) (Workflow instructions), [`references/presenter-mode.md`](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/presenter-mode.md) (Presenter guidance), [`assets/template.html`](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template.html) (Editorial template), [`assets/template-swiss.html`](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template-swiss.html) (Swiss template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Deck authoring"]
  node_skill["Workflow instructions<br/>[SKILL.md]"]
  node_checklist["Deck pitfalls<br/>[checklist.md]"]
  node_htmlresult["HTML deck"]
end

subgraph group_design["Visual systems"]
  node_stylea["Editorial layouts<br/>[layouts.md]"]
  node_styleb["Swiss layouts<br/>[layouts-swiss.md]"]
  node_themes["Theme presets<br/>[themes.md]"]
  node_swissthemes["Swiss themes<br/>[themes-swiss.md]"]
  node_components["Deck components<br/>[components.md]"]
  node_templatea["Editorial template<br/>[template.html]"]
  node_templateswiss["Swiss template"]
end

subgraph group_media["Visual outputs"]
  node_imageguidance["Image prompts<br/>[image-prompts.md]"]
  node_screenshotguidance["Screenshot framing"]
  node_coveroutput["Social covers"]
end

subgraph group_presenting["Presentation"]
  node_presenterguide["Presenter guidance<br/>[presenter-mode.md]"]
  node_presenterruntime["Presenter runtime<br/>[template.html]"]
  node_swissruntime["Swiss presenter runtime"]
end

node_user(("Presenter or author"))
node_agent(("Coding agent"))
node_imagegenerator(("Codex image generation"))

node_user -->|"requests output"| node_agent
node_agent -->|"follows workflow"| node_skill
node_skill -->|"consults pitfalls"| node_checklist
node_skill -->|"selects layouts"| node_stylea
node_skill -->|"selects layouts"| node_styleb
node_skill -->|"selects themes"| node_themes
node_skill -->|"selects themes"| node_swissthemes
node_skill -->|"uses components"| node_components
node_agent -->|"adapts template"| node_templatea
node_agent -->|"adapts template"| node_templateswiss
node_agent -->|"creates deck"| node_htmlresult
node_skill -.->|"guides visuals"| node_imageguidance
node_agent -.->|"requests images"| node_imagegenerator
node_agent -.->|"frames screenshots"| node_screenshotguidance
node_agent -.->|"creates covers"| node_coveroutput
node_skill -->|"guides rehearsal"| node_presenterguide
node_templatea -->|"includes runtime"| node_presenterruntime
node_templateswiss -->|"includes runtime"| node_swissruntime
node_presenterguide -->|"documents controls"| node_presenterruntime
node_presenterguide -->|"documents controls"| node_swissruntime

click node_skill "https://github.com/thititj/guizang-ppt-skill-en/blob/main/SKILL.md"
click node_checklist "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/checklist.md"
click node_stylea "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/layouts.md"
click node_styleb "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/layouts-swiss.md"
click node_themes "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/themes.md"
click node_swissthemes "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/themes-swiss.md"
click node_components "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/components.md"
click node_templatea "https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template.html"
click node_templateswiss "https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template-swiss.html"
click node_imageguidance "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/image-prompts.md"
click node_screenshotguidance "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/screenshot-framing.md"
click node_coveroutput "https://github.com/thititj/guizang-ppt-skill-en/tree/main/assets"
click node_presenterguide "https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/presenter-mode.md"
click node_presenterruntime "https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template.html"
click node_swissruntime "https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template-swiss.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_checklist,node_htmlresult toneBlue
class node_stylea,node_styleb,node_themes,node_swissthemes,node_components,node_templatea,node_templateswiss toneAmber
class node_imageguidance,node_screenshotguidance,node_coveroutput toneMint
class node_presenterguide,node_presenterruntime,node_swissruntime toneRose
class node_user,node_agent,node_imagegenerator toneIndigo
```

## Components

### Deck authoring

- [Workflow instructions](https://github.com/thititj/guizang-ppt-skill-en/blob/main/SKILL.md): `SKILL.md`
- [Deck pitfalls](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/checklist.md): `references/checklist.md`
- **HTML deck**

### Visual systems

- [Editorial layouts](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/layouts.md): `references/layouts.md`
- [Swiss layouts](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/layouts-swiss.md): `references/layouts-swiss.md`
- [Theme presets](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/themes.md): `references/themes.md`
- [Swiss themes](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/themes-swiss.md): `references/themes-swiss.md`
- [Deck components](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/components.md): `references/components.md`
- [Editorial template](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template.html): `assets/template.html`
- [Swiss template](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template-swiss.html): `assets/template-swiss.html`

### Visual outputs

- [Image prompts](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/image-prompts.md): `references/image-prompts.md`
- [Screenshot framing](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/screenshot-framing.md): `references/screenshot-framing.md`
- [Social covers](https://github.com/thititj/guizang-ppt-skill-en/tree/main/assets): `assets`

### Presentation

- [Presenter guidance](https://github.com/thititj/guizang-ppt-skill-en/blob/main/references/presenter-mode.md): `references/presenter-mode.md`
- [Presenter runtime](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template.html): `assets/template.html`
- [Swiss presenter runtime](https://github.com/thititj/guizang-ppt-skill-en/blob/main/assets/template-swiss.html): `assets/template-swiss.html`

### Other components

- **Presenter or author**
- **Coding agent**
- **Codex image generation**

## Connections

- Presenter or author → Coding agent: requests output
- Coding agent → Workflow instructions: follows workflow
- Workflow instructions → Deck pitfalls: consults pitfalls
- Workflow instructions → Editorial layouts: selects layouts
- Workflow instructions → Swiss layouts: selects layouts
- Workflow instructions → Theme presets: selects themes
- Workflow instructions → Swiss themes: selects themes
- Workflow instructions → Deck components: uses components
- Coding agent → Editorial template: adapts template
- Coding agent → Swiss template: adapts template
- Coding agent → HTML deck: creates deck
- Workflow instructions → Image prompts: guides visuals
- Coding agent → Codex image generation: requests images
- Coding agent → Screenshot framing: frames screenshots
- Coding agent → Social covers: creates covers
- Workflow instructions → Presenter guidance: guides rehearsal
- Editorial template → Presenter runtime: includes runtime
- Swiss template → Swiss presenter runtime: includes runtime
- Presenter guidance → Presenter runtime: documents controls
- Presenter guidance → Swiss presenter runtime: documents controls