Workflow — 5 steps
Do not start writing slides until you complete steps 1-3.
Step 1: Plan Content
You MUST think through all the planning questions below before writing any HTML. Writing a plan.md file is optional for short/simple decks — you may keep the plan in your reasoning instead of creating a file. For long, complex decks (8+ content slides or involving multiple generated images/charts), you SHOULD create a plan.md file in your temporary work directory to maintain consistency. Regardless of whether you write it down, every field below MUST be considered and decided upon. The plan drives all subsequent steps. If a plan.md is written, it is an intermediate planning artifact only — it must NOT appear in the final deliverables presented to the user.
📖 Load Best Practice Reference
Before planning, identify the presentation type and load the matching best-practice guide. Use the full path including the category subdirectory when reading:
| # |
Type |
Path |
| 01 |
Pitch Deck |
references/slide_best_practices/01_startup_funding/01_pitch_deck.md |
| 02 |
Elevator Pitch |
references/slide_best_practices/01_startup_funding/02_elevator_pitch.md |
| 03 |
Business Plan |
references/slide_best_practices/01_startup_funding/03_business_plan.md |
| 04 |
Investor Update |
references/slide_best_practices/01_startup_funding/04_investor_update.md |
| 05 |
Quarterly Business Review |
references/slide_best_practices/02_corporate_management/05_quarterly_business_review.md |
| 06 |
All-Hands Meeting |
references/slide_best_practices/02_corporate_management/06_all_hands_meeting.md |
| 07 |
Project Kickoff |
references/slide_best_practices/02_corporate_management/07_project_kickoff.md |
| 08 |
Post-Mortem |
references/slide_best_practices/02_corporate_management/08_post_mortem.md |
| 09 |
Onboarding |
references/slide_best_practices/02_corporate_management/09_onboarding.md |
| 10 |
Change Management |
references/slide_best_practices/02_corporate_management/10_change_management.md |
| 11 |
Sales Deck |
references/slide_best_practices/03_sales_marketing/11_sales_deck.md |
| 12 |
Product Launch |
references/slide_best_practices/03_sales_marketing/12_product_launch.md |
| 13 |
Company Profile |
references/slide_best_practices/03_sales_marketing/13_company_profile.md |
| 14 |
Case Study |
references/slide_best_practices/03_sales_marketing/14_case_study.md |
| 15 |
Media Kit |
references/slide_best_practices/03_sales_marketing/15_media_kit.md |
| 16 |
Brand Guidelines |
references/slide_best_practices/03_sales_marketing/16_brand_guidelines.md |
| 17 |
Thesis Defense |
references/slide_best_practices/04_academic_education/17_thesis_defense.md |
| 18 |
Lecture |
references/slide_best_practices/04_academic_education/18_lecture.md |
| 19 |
Research Poster |
references/slide_best_practices/04_academic_education/19_research_poster.md |
| 20 |
Book Review |
references/slide_best_practices/04_academic_education/20_book_review.md |
| 21 |
Workshop |
references/slide_best_practices/04_academic_education/21_workshop.md |
| 22 |
Market Analysis |
references/slide_best_practices/05_consulting_strategy/22_market_analysis.md |
| 23 |
Strategic Plan |
references/slide_best_practices/05_consulting_strategy/23_strategic_plan.md |
| 24 |
Consulting Proposal |
references/slide_best_practices/05_consulting_strategy/24_consulting_proposal.md |
| 25 |
Persona Analysis |
references/slide_best_practices/05_consulting_strategy/25_persona_analysis.md |
| 26 |
Portfolio |
references/slide_best_practices/06_personal_creative/26_portfolio.md |
| 27 |
Visual Resume |
references/slide_best_practices/06_personal_creative/27_visual_resume.md |
| 28 |
Travelogue |
references/slide_best_practices/06_personal_creative/28_travelogue.md |
| 29 |
Moodboard |
references/slide_best_practices/06_personal_creative/29_moodboard.md |
| 30 |
Event Speech |
references/slide_best_practices/06_personal_creative/30_event_speech.md |
| 31 |
Self-Introduction |
references/slide_best_practices/06_personal_creative/31_self_introduction.md |
| 32 |
Webinar |
references/slide_best_practices/06_personal_creative/32_webinar.md |
How to use: Read the matched guide to adopt its narrative structure, slide role sequence, language style & tone, and content depth per slide. If the user's request doesn't map to a single type, blend the closest 2 guides.
The plan consists of two sections:
1A. Narrative Arc
A numbered table — every row = one slide. Lock Layout + Animation at planning time.
| # | Title | Role | Content Summary | Visual | Layout | Animation | Decoration |
|---|---|---|---|---|---|---|---|
| 1 | Welcome to presentation | Cover | Tagline + logo | [Built-in] | cover | blur-in | deco-soft-gradient |
| 2 | What We'll Cover | TOC | 4 topics | [Built-in] | toc | stagger-list | — |
| 3 | The Problem | Section | Chapter divider | [Built-in] | section-divider | rise-in | deco-ambient-purple |
| 4 | Scale Challenges | Body | 3 stats + chart | [ECharts:chart-bar-echarts] | chart-bar-echarts | fade-up | deco-grid |
| 5 | Our Solution | Section | Chapter divider | [Built-in] | section-divider | rise-in | deco-ambient-purple |
| 6 | Architecture | Body | 3-tier diagram | [Built-in] | arch-diagram | path-draw | deco-scanlines |
| ... | | | | | | | |
| N | Thank You | Closing | Contact + QR | [Built-in] | thanks | confetti-burst | — |
Visual is a slide-level summary. If a slide contains multiple assets, say so explicitly, e.g. [GenerateImage ×3], [External ×4], or Lead portrait + 2 product shots.
Layout — file name from templates/single-page/ (without .html):
| Slide role |
Recommended layouts |
| Cover |
cover |
| TOC |
toc |
| Section divider |
section-divider |
| Bullets / text |
bullets, two-column, three-column |
| Quote |
big-quote |
| Stats / KPIs |
stat-highlight, kpi-grid |
| Data chart |
chart-bar-echarts, chart-line-echarts, chart-pie-echarts, chart-radar-echarts |
| Advanced chart |
chart-sankey, chart-heatmap, chart-tree, chart-graph |
| Table |
table |
| Code |
code, diff, terminal, cyber-trace |
| Flow / arch |
flow-diagram, arch-diagram, mindmap |
| Process |
process-steps |
| Timeline |
timeline-horizontal, timeline-vertical, roadmap, gantt |
| Comparison |
comparison, pros-cons |
| Image |
image-hero, image-grid, image-text-split, image-caption-card, image-fullbleed |
| Alert / Callout |
alert-callout |
| Feature grid |
glass-cards (dark), macaron-grid (light) |
| CTA / Closing |
cta, thanks |
Animation — CSS animation (data-anim) or Canvas FX (data-fx). Use — if none needed:
| Category |
Names |
| Directional fades |
fade-up, fade-down, fade-left, fade-right |
| Dramatic entries |
rise-in, drop-in, zoom-pop, blur-in, glitch-in |
| Text effects |
typewriter, neon-glow, shimmer-sweep, gradient-flow |
| Lists & numbers |
stagger-list, counter-up |
| SVG / geometry |
path-draw, morph-shape |
| 3D |
parallax-tilt, card-flip-3d, cube-rotate-3d, page-turn-3d, perspective-zoom |
| Ambient |
marquee-scroll, kenburns, confetti-burst, spotlight, ripple-reveal |
| Canvas FX |
particle-burst, confetti-cannon, firework, starfield, matrix-rain, knowledge-graph, neural-net, constellation, galaxy-swirl, etc. |
Decoration — persistent atmosphere effects (deco-* class on .slide). Unlike animations (play once), decorations remain visible. Wire via <link href="../assets/decorations.css">:
| Category |
Names |
| Overlays |
deco-scanlines, deco-grid, deco-rainbow-bar, deco-danger-stripe, deco-danger-stripe-bottom |
| Ambient light |
deco-ambient-purple, deco-orbs, deco-blob, deco-soft-gradient |
| Surface |
deco-glass-surface, deco-glow-text |
Use — if no decoration needed. Multiple effects can stack with + (e.g. deco-scanlines + deco-grid). If any slide uses decorations, add <link href="./_shared/decorations.css"> to <head>. See references/decorations.md for pseudo-element conflicts and combo suggestions.
Rules:
- One core message per slide. If you cannot summarize in one sentence, split it.
- Fixed overhead: Cover (1) + TOC (1) + Closing (1) = 3 slides minimum before content.
- Cover slide must be minimal. Only: title, subtitle (optional), speaker name (optional), date (optional). Do NOT add stats cards, KPI numbers, feature lists, or any other information blocks. The cover exists solely to set the tone and introduce the topic.
- Closing slide must be minimal. Only: a short closing phrase (e.g. "Thank You", "谢谢") and optionally one brief sentence summarizing the deck's message. Do NOT add cards, feature grids, bullet lists, CTA buttons, or any substantive content. The closing exists solely to signal the end.
- Section dividers are mandatory for 6+ body slides. Preceding each major chapter/topic with a
section-divider slide helps the audience follow the narrative structure. Plan dividers into the Narrative Arc table — they count toward total slide count.
- Reading only the titles should tell the whole story.
- Max 1–2 animations per slide. Prefer
fade-up as safe default; use dramatic/FX sparingly.
1B. Visual Elements Inventory
List every visual asset with a specific tag. This section is asset-level, not slide-level: one row = one concrete asset or asset slot. If one slide contains multiple visuals, repeat the slide number with suffixes like 6a, 6b, 6c. Use [none] only for slides that truly have no visual asset at all.
| # | Visual | Tag | Notes |
|---|---|---|---|
| 1 | — | [none] | Cover — text only |
| 3 | Hero illustration | [GenerateImage] | Abstract shapes, 1920×1080 |
| 4 | Revenue bar chart | [ECharts:chart-bar-echarts] | Q1–Q4 data |
| 5 | Architecture diagram | [Built-in] | 3-layer microservice, use arch-diagram layout |
| 6a | Card 1: customer interview portrait | [GenerateImage] | 4:3, natural indoor lighting |
| 6b | Card 2: product usage close-up | [GenerateImage] | 4:3, clean desk scene |
| 6c | Card 3: team workshop moment | [GenerateImage] | 4:3, collaborative office setting |
| 7 | User flow sankey | [ECharts:chart-sankey] | Signup → Activation |
| N | — | [none] | Closing — text only |
Tags:
[none] — no visual (text-only slides)[Built-in] — CSS-only graphics, icons, emoji[ECharts:<template>] — exact template name: chart-bar-echarts, chart-line-echarts, chart-pie-echarts, chart-radar-echarts, chart-sankey, chart-heatmap, chart-tree, chart-graph[GenerateImage] — AI-generated illustrations/backgrounds (recommended)[External] — stock photos, logos, downloaded assets
Rules:
- Do not collapse multiple assets on the same slide into one row. A 3-card image slide needs 3 inventory rows.
- Match asset count to layout slots.
image-caption-card usually needs 3 images; image-grid can need up to 7; image-text-split usually needs 1.
- Only use
[none] when the slide is genuinely text-only or built entirely from built-in shapes/icons.
Step 2: Choose Theme
Use references/themes.md. When in doubt:
- Engineers →
catppuccin-mocha / tokyo-night / dracula / indigo-code
- Designers / product →
editorial-serif / aurora / soft-pastel / fuchsia-cyan
- Execs →
minimal-white / corporate-clean / swiss-grid / navy-formal
- Consumers →
xiaohongshu-white / sunset-warm / soft-pastel
- Cyber / CLI / infra →
terminal-green / blueprint / gruvbox-dark
- Pitch / bold →
neo-brutalism / pitch-deck-vc / bauhaus / indigo-mint
- Launch / product reveal →
glassmorphism / aurora
- Academic →
academic-paper / editorial-serif / scholar-teal
- Party / government →
crimson-gold / crimson-night
- Training / edu →
navy-formal / scholar-teal / alert-crimson / indigo-code
- Finance / data →
ledger-dark / amber-purple / arctic-cool
- Luxury / brand →
luxury-noir / warm-cafe / japanese-minimal
- Nature / eco →
forest-gold / clean-teal
Wire as <link id="theme-link" href="./_shared/themes/NAME.css"> and list 3-5 alternatives in data-themes.
Aesthetic Direction
Design each deck as a specific visual world, not a generic AI-generated slide theme.
- Create atmosphere and depth. Don't default to flat solid-color backgrounds when the concept calls for more. Use contextual textures and effects such as gradient meshes, SVG noise, geometric patterns, layered transparencies, dramatic shadows, decorative borders, grain overlays, or custom cursors when they strengthen the concept.
- Avoid generic AI aesthetics. Do not fall back to overused font families (
Inter, Roboto, Arial, generic system UI stacks), cliched color recipes (especially purple gradients on white), predictable SaaS blocks, or cookie-cutter card grids that ignore the topic's context.
- Interpret creatively. Make unexpected but coherent choices that feel designed for the subject matter, audience, and tone. No two decks should converge on the same aesthetic by default.
- Vary the design language across generations. Deliberately explore different light/dark directions, typography pairings, textures, framing devices, and visual rhythms. Do not repeatedly converge on the same familiar choices such as
Space Grotesk.
- Match implementation complexity to the vision. Maximalist directions should earn their richness with more elaborate code, layering, and motion. Minimalist or refined directions should earn their elegance through restraint, spacing, typography, and subtle details.
Background Texture (--bg-texture)
Every .slide supports a --bg-texture CSS variable that layers a subtle texture/gradient above the solid --bg color. Many themes ship a default texture (radial glows, SVG noise, etc.); slides that don't set it fall back to none (plain color, same as before).
- Per-slide override — use inline
style to change or disable texture on a single slide:<!-- disable texture on this slide -->
<section class="slide" style="--bg-texture: none;">
<!-- custom gradient on this slide only -->
<section class="slide" style="--bg-texture: radial-gradient(circle at 50% 50%, rgba(255,100,50,.1), transparent 60%);">
- AI-generated background image — for hero/statement slides, use the
image-fullbleed layout template which provides a full-screen background image + dark overlay for text readability. Reference the generated image from assets/:<!-- image-fullbleed template: full-screen bg + overlay -->
<section class="slide" style="background: linear-gradient(rgba(0,0,0,.55), rgba(0,0,0,.55)), url('assets/cityscape_1024x576.png') center/cover;">
Step 3: Image Acquisition
Use images deliberately — not every slide needs one. Refer to the Visual Elements Inventory (Step 1B) for which specific assets need images. When an inventory row is tagged [GenerateImage], generate that asset directly with GenerateImage.
Workflow
- Decide which inventory items need generated images based on the Visual Elements Inventory. List only the
[GenerateImage] rows, noting for each:
- A descriptive prompt (what the image should depict)
- Purpose: background, hero image, supporting illustration, or icon
- Desired aspect ratio (16:9 for full-bleed backgrounds, 4:3 for content areas, 1:1 for headshots)
- Target slide slot if needed (e.g.
6a left card, 6b middle card, 6c right card)
- Generate images with GenerateImage — call GenerateImage directly (no subagent needed). Generate each asset one by one, saving them to the deck's
assets/ directory:
- Write a detailed, specific prompt for each image describing the desired scene, style, color tones, and mood.
- Choose the right
image_size for the target aspect ratio:
landscape_16_9 (2560×1440) — full-slide backgrounds, wide layoutslandscape_4_3 (2240×1680) — content area illustrationssquare (1920×1920) — headshots, profile images, square iconsportrait_4_3 (1680×2240) — portraitportrait_16_9 (1440×2560) — tall portrait
- Save as
assets/{name}_{w}x{h}.png (e.g. assets/hero_16x9.png)
- Never merge multiple
[GenerateImage] rows from one slide into a single output file.
- Use the file paths in your slide HTML:
<img src="assets/hero_1024x576.png" alt="Hero illustration">
Prompt Tips for GenerateImage
- Be specific about style: "a modern flat illustration of…" or "a photorealistic aerial view of…"
- Include color guidance: "using warm tones of terracotta and sage green" to match the slide palette
- Describe composition: "left side shows X, right side shows Y, with negative space in the center for text overlay"
- Specify mood: "professional, clean, and minimal" vs "vibrant, energetic, and bold"
- Avoid text in images: Generated text is often garbled — use HTML text elements instead
Guidelines
- Specify dimensions. Always choose the right
image_size for the target aspect ratio.
- Save to the deck's
assets/ directory. All images use {name}_{w}x{h}.png naming so they can be referenced by path and inlined correctly.
- Match the deck's color palette. Include the primary/accent colors in your GenerateImage prompt so images feel cohesive with the slides.
- Prefer illustration style for consistency. AI-generated photos can look uncanny — illustrations, abstract art, and stylized graphics tend to produce better results.
Other Asset Types
- Data charts — use ECharts templates (
templates/single-page/chart-*.html), no need to pre-generate images
See references/image-generation.md for detailed guidance on all asset types.
Step 4: Build HTML
Scaffold the deck directory:
Linux / macOS:
bash ./scripts/new-deck.sh my-talk <workspace-dir>
Windows (native PowerShell):
pwsh -File ./scripts/new-deck.ps1 my-talk <workspace-dir>
This creates <workspace-dir>/my-talk/ with:
my-talk/
├── my-talk.html ← product HTML (references ./_shared/ and ./assets/)
├── assets/ ← generated images, chart JS
└── _shared/ ← minimal shared assets (pre-populated)
├── base.css
├── fonts.css
├── decorations.css
├── runtime.js
├── echarts.min.js
├── echarts-theme-sync.js
├── animations/
│ ├── animations.css
│ ├── fx-runtime.js
│ └── fx/ ← copy needed fx scripts here
└── themes/ ← copy needed theme CSS here
Copy the chosen theme into _shared/themes/:
cp <skill-dir>/assets/themes/<theme>.css <workspace-dir>/my-talk/_shared/themes/
Pick layouts from templates/single-page/ per slide in plan.md
Copy <section class="slide" data-deck-label="...">…</section> blocks, replace demo data
For charts, copy from ECharts templates (chart-*-echarts.html, chart-sankey.html, etc.)
- In the generated deck, use
./_shared/echarts.min.js and ./_shared/echarts-theme-sync.js (NOT the ../../assets/ paths from template source files)
Add data-anim / data-fx animations sparingly; copy needed fx scripts:
cp <skill-dir>/assets/animations/fx/<effect>.js <workspace-dir>/my-talk/_shared/animations/fx/
Add decorations: if plan.md has any deco-* entries, uncomment <link href="./_shared/decorations.css"> in <head>, then add matching classes to each <section class="slide deco-xxx">
Add <div class="notes">…</div> for speaker notes
Place generated images and chart JS in assets/
⚠️ Every HTML file must include the following meta tags in <head>:
<meta name="x-content-type" content="presentation" />
<meta name="x-presentation-version" content="1.0" />
<meta name="x-presentation-indicator" content="deck-stage .slide" />
The scaffold already includes these. If you create additional HTML files in the same deck folder, add all three meta tags to each one.
Step 5: Deliver
Do NOT preview or validate. The model must NOT start a local server, open the HTML in a browser, or run any verification step. The deck is built directly in the user's workspace — no separate deploy step is needed.
After completing the HTML, inform the user of:
- Folder location:
<workspace-dir>/my-talk/
- Entry file:
my-talk.html
- Keyboard controls:
→ / Space / Enter: Next slide←: Previous slideF or F11: Toggle fullscreen mode
- Recommend fullscreen for the best presentation experience
Authoring rules (important)
- Always start from a template. Don't author slides from scratch.
- Design for a distinctive aesthetic. Make slides feel purpose-built for the topic, not like a generic AI deck.
- Use tokens, not literal colors. Good:
color: var(--text-1). Bad: color: #111.
- Make backgrounds do real design work. Use textures, overlays, shadows, borders, and atmospheric layers when they improve the concept; don't rely on plain fills by default.
- Avoid default AI taste. Skip overused font stacks, cliched purple-on-white gradients, and predictable SaaS-card layouts unless the brief explicitly demands them.
- Vary themes and typography across decks. Do not repeatedly converge on the same fonts, light/dark balance, or visual motifs.
- Scale code complexity to the aesthetic. Rich visual directions may require richer HTML/CSS/animation systems; restrained designs should show precision rather than emptiness.
- ECharts always use SVG renderer.
echarts.init(el, null, { renderer: 'svg' }) for crisp vector output.
- Register ECharts to theme sync.
window.__deckECharts.register(chart, getColorOption) for T-key support.
- Don't invent new layout files. Prefer composing existing ones.
- Keyboard-first. Always include
<script src="./_shared/runtime.js"></script>.
- Wrap all slides in
<deck-stage width="1920" height="1080"> — this is the deck boundary and canvas size declaration. Never use <div class="deck">.
- One
.slide per logical page. runtime.js makes .slide.active visible.
- Every
.slide must have data-deck-label — the page title for structural identification (e.g. data-deck-label="项目进展").
- Supply notes. Wrap in
<div class="notes">…</div> inside each slide.
- NEVER put presenter-only text on the slide itself. Use
.notes div.
- Use
deco-* classes for atmosphere. Don't inline atmosphere CSS — use decorations.css instead.
- NEVER override
.slide positioning. base.css sets .slide { position: absolute; opacity: 0 } so runtime.js can show one page at a time via .active. Adding position: relative (or any override to position/opacity/display on .slide) in your <style> will break the slide system and cause all pages to stack visibly on one scroll. If you need layout tweaks, scope them to a child element inside .slide.
- Use direct-child selectors for sizing in nested layouts. When setting fixed
height/width on .card (or any reusable class) inside a grid wrapper, always use > (e.g. .my-grid > .card { height: 500px }) to avoid accidentally sizing nested children. The base .card class is used at multiple nesting levels — a descendant selector like .wrapper .card will cascade into inner grids and cause layout overflow/misalignment.
Writing guide
See references/authoring-guide.md for the
step-by-step walkthrough.
Catalogs (load when needed)
- references/slide_best_practices/ — 32 presentation-type best practices (narrative structure, language style, content depth). Load in Step 1.
- references/themes.md — all 52 themes with when-to-use.
- references/layouts.md — all 56 layout types (48 original + 8 ECharts).
- references/animations.md — 27 CSS + 20 canvas FX animations.
- references/decorations.md — 12 ambient decoration effects (
deco-* classes).
- references/presenter-mode.md — 演讲者模式 + 逐字稿编写指南.
- references/image-generation.md — GenerateImage guide.
- references/authoring-guide.md — full workflow.
File structure
html-deck/
├── SKILL.md (this file)
├── references/ (detailed catalogs, load as needed)
├── assets/
│ ├── base.css (tokens + primitives — do not edit per deck)
│ ├── fonts.css (webfont imports)
│ ├── runtime.js (keyboard + presenter + overview + theme cycle + edit mode)
│ ├── echarts.min.js (ECharts 5.5.0 — local bundle, no CDN)
│ ├── echarts-theme-sync.js (ECharts ↔ CSS theme auto-sync)
│ ├── decorations.css (12 ambient decoration effects)
│ ├── themes/*.css (52 token overrides, one per theme)
│ └── animations/
│ ├── animations.css (27 named CSS entry animations)
│ ├── fx-runtime.js (auto-init [data-fx] on slide enter)
│ └── fx/*.js (20 canvas FX modules)
├── templates/
│ ├── deck.html (minimal 6-slide starter — reference only)
│ ├── theme-showcase.html (52 slides, iframe-isolated per theme)
│ ├── layout-showcase.html (iframe tour of all layouts)
│ ├── animation-showcase.html (FX + CSS animation slides)
│ └── single-page/*.html (56 layout files — 48 original + 8 ECharts)
├── scripts/
│ ├── new-deck.sh (scaffold a deck directory — Linux/macOS)
│ └── new-deck.ps1 (scaffold a deck directory — Windows native PowerShell)
Deck output structure (created by new-deck.sh)
<workspace-dir>/<name>/
├── <name>.html ← product HTML with x-content-type meta tags
├── assets/ ← generated images, chart JS
│ ├── *.png
│ └── *.js
└── _shared/
├── base.css
├── fonts.css
├── decorations.css
├── animations/
│ ├── animations.css
│ ├── fx-runtime.js
│ └── fx/*.js
├── themes/
│ └── *.css
├── runtime.js
├── echarts.min.js
└── echarts-theme-sync.js
License & author
MIT. Copyright (c) 2026.
1---2name: html-deck3description: Create stunning, animation-rich HTML slide decks from scratch. Outputs a self-contained HTML file that opens in any browser, agent-friendly, visually impressive and pixel-perfect across all platforms. Use when the user says "演示文稿", "presentation", "slides", or "deck" WITHOUT explicitly mentioning "PPT" or "ppt" — if the user says "PPT"/"ppt", route to the `pptx` skill instead. Covers building a brand-new presentation from a topic, outline, document, or Markdown — i.e. no existing .pptx file is involved. The deliverable is always HTML.4---56## Workflow — 5 steps78**Do not start writing slides until you complete steps 1-3.**910### Step 1: Plan Content1112**You MUST think through all the planning questions below before writing any HTML.** Writing a `plan.md` file is optional for short/simple decks — you may keep the plan in your reasoning instead of creating a file. For long, complex decks (8+ content slides or involving multiple generated images/charts), you SHOULD create a `plan.md` file in your temporary work directory to maintain consistency. Regardless of whether you write it down, every field below MUST be considered and decided upon. The plan drives all subsequent steps. **If a `plan.md` is written, it is an intermediate planning artifact only — it must NOT appear in the final deliverables presented to the user.**131415#### 📖 Load Best Practice Reference1617Before planning, identify the presentation type and load the matching best-practice guide. **Use the full path including the category subdirectory** when reading:1819| # | Type | Path |20|---|---|---|21| 01 | Pitch Deck | `references/slide_best_practices/01_startup_funding/01_pitch_deck.md` |22| 02 | Elevator Pitch | `references/slide_best_practices/01_startup_funding/02_elevator_pitch.md` |23| 03 | Business Plan | `references/slide_best_practices/01_startup_funding/03_business_plan.md` |24| 04 | Investor Update | `references/slide_best_practices/01_startup_funding/04_investor_update.md` |25| 05 | Quarterly Business Review | `references/slide_best_practices/02_corporate_management/05_quarterly_business_review.md` |26| 06 | All-Hands Meeting | `references/slide_best_practices/02_corporate_management/06_all_hands_meeting.md` |27| 07 | Project Kickoff | `references/slide_best_practices/02_corporate_management/07_project_kickoff.md` |28| 08 | Post-Mortem | `references/slide_best_practices/02_corporate_management/08_post_mortem.md` |29| 09 | Onboarding | `references/slide_best_practices/02_corporate_management/09_onboarding.md` |30| 10 | Change Management | `references/slide_best_practices/02_corporate_management/10_change_management.md` |31| 11 | Sales Deck | `references/slide_best_practices/03_sales_marketing/11_sales_deck.md` |32| 12 | Product Launch | `references/slide_best_practices/03_sales_marketing/12_product_launch.md` |33| 13 | Company Profile | `references/slide_best_practices/03_sales_marketing/13_company_profile.md` |34| 14 | Case Study | `references/slide_best_practices/03_sales_marketing/14_case_study.md` |35| 15 | Media Kit | `references/slide_best_practices/03_sales_marketing/15_media_kit.md` |36| 16 | Brand Guidelines | `references/slide_best_practices/03_sales_marketing/16_brand_guidelines.md` |37| 17 | Thesis Defense | `references/slide_best_practices/04_academic_education/17_thesis_defense.md` |38| 18 | Lecture | `references/slide_best_practices/04_academic_education/18_lecture.md` |39| 19 | Research Poster | `references/slide_best_practices/04_academic_education/19_research_poster.md` |40| 20 | Book Review | `references/slide_best_practices/04_academic_education/20_book_review.md` |41| 21 | Workshop | `references/slide_best_practices/04_academic_education/21_workshop.md` |42| 22 | Market Analysis | `references/slide_best_practices/05_consulting_strategy/22_market_analysis.md` |43| 23 | Strategic Plan | `references/slide_best_practices/05_consulting_strategy/23_strategic_plan.md` |44| 24 | Consulting Proposal | `references/slide_best_practices/05_consulting_strategy/24_consulting_proposal.md` |45| 25 | Persona Analysis | `references/slide_best_practices/05_consulting_strategy/25_persona_analysis.md` |46| 26 | Portfolio | `references/slide_best_practices/06_personal_creative/26_portfolio.md` |47| 27 | Visual Resume | `references/slide_best_practices/06_personal_creative/27_visual_resume.md` |48| 28 | Travelogue | `references/slide_best_practices/06_personal_creative/28_travelogue.md` |49| 29 | Moodboard | `references/slide_best_practices/06_personal_creative/29_moodboard.md` |50| 30 | Event Speech | `references/slide_best_practices/06_personal_creative/30_event_speech.md` |51| 31 | Self-Introduction | `references/slide_best_practices/06_personal_creative/31_self_introduction.md` |52| 32 | Webinar | `references/slide_best_practices/06_personal_creative/32_webinar.md` |5354**How to use**: Read the matched guide to adopt its **narrative structure**, **slide role sequence**, **language style & tone**, and **content depth per slide**. If the user's request doesn't map to a single type, blend the closest 2 guides.5556The plan consists of two sections:5758#### 1A. Narrative Arc5960A numbered table — every row = one slide. Lock Layout + Animation at planning time.6162```63| # | Title | Role | Content Summary | Visual | Layout | Animation | Decoration |64|---|---|---|---|---|---|---|---|65| 1 | Welcome to presentation | Cover | Tagline + logo | [Built-in] | cover | blur-in | deco-soft-gradient |66| 2 | What We'll Cover | TOC | 4 topics | [Built-in] | toc | stagger-list | — |67| 3 | The Problem | Section | Chapter divider | [Built-in] | section-divider | rise-in | deco-ambient-purple |68| 4 | Scale Challenges | Body | 3 stats + chart | [ECharts:chart-bar-echarts] | chart-bar-echarts | fade-up | deco-grid |69| 5 | Our Solution | Section | Chapter divider | [Built-in] | section-divider | rise-in | deco-ambient-purple |70| 6 | Architecture | Body | 3-tier diagram | [Built-in] | arch-diagram | path-draw | deco-scanlines |71| ... | | | | | | | |72| N | Thank You | Closing | Contact + QR | [Built-in] | thanks | confetti-burst | — |73```7475`Visual` is a slide-level summary. If a slide contains multiple assets, say so explicitly, e.g. `[GenerateImage ×3]`, `[External ×4]`, or `Lead portrait + 2 product shots`.7677**Layout** — file name from `templates/single-page/` (without `.html`):7879| Slide role | Recommended layouts |80| --------------- | --------------------------------------------------------------------------------------- |81| Cover | `cover` |82| TOC | `toc` |83| Section divider | `section-divider` |84| Bullets / text | `bullets`, `two-column`, `three-column` |85| Quote | `big-quote` |86| Stats / KPIs | `stat-highlight`, `kpi-grid` |87| Data chart | `chart-bar-echarts`, `chart-line-echarts`, `chart-pie-echarts`, `chart-radar-echarts` |88| Advanced chart | `chart-sankey`, `chart-heatmap`, `chart-tree`, `chart-graph` |89| Table | `table` |90| Code | `code`, `diff`, `terminal`, `cyber-trace` |91| Flow / arch | `flow-diagram`, `arch-diagram`, `mindmap` |92| Process | `process-steps` |93| Timeline | `timeline-horizontal`, `timeline-vertical`, `roadmap`, `gantt` |94| Comparison | `comparison`, `pros-cons` |95| Image | `image-hero`, `image-grid`, `image-text-split`, `image-caption-card`, `image-fullbleed` |96| Alert / Callout | `alert-callout` |97| Feature grid | `glass-cards` (dark), `macaron-grid` (light) |98| CTA / Closing | `cta`, `thanks` |99100**Animation** — CSS animation (`data-anim`) or Canvas FX (`data-fx`). Use `—` if none needed:101102| Category | Names |103| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |104| Directional fades | `fade-up`, `fade-down`, `fade-left`, `fade-right` |105| Dramatic entries | `rise-in`, `drop-in`, `zoom-pop`, `blur-in`, `glitch-in` |106| Text effects | `typewriter`, `neon-glow`, `shimmer-sweep`, `gradient-flow` |107| Lists & numbers | `stagger-list`, `counter-up` |108| SVG / geometry | `path-draw`, `morph-shape` |109| 3D | `parallax-tilt`, `card-flip-3d`, `cube-rotate-3d`, `page-turn-3d`, `perspective-zoom` |110| Ambient | `marquee-scroll`, `kenburns`, `confetti-burst`, `spotlight`, `ripple-reveal` |111| Canvas FX | `particle-burst`, `confetti-cannon`, `firework`, `starfield`, `matrix-rain`, `knowledge-graph`, `neural-net`, `constellation`, `galaxy-swirl`, etc. |112113**Decoration** — persistent atmosphere effects (`deco-*` class on `.slide`). Unlike animations (play once), decorations remain visible. Wire via `<link href="../assets/decorations.css">`:114115| Category | Names |116| ------------- | ---------------------------------------------------------------------------------------------------- |117| Overlays | `deco-scanlines`, `deco-grid`, `deco-rainbow-bar`, `deco-danger-stripe`, `deco-danger-stripe-bottom` |118| Ambient light | `deco-ambient-purple`, `deco-orbs`, `deco-blob`, `deco-soft-gradient` |119| Surface | `deco-glass-surface`, `deco-glow-text` |120121Use `—` if no decoration needed. Multiple effects can stack with `+` (e.g. `deco-scanlines + deco-grid`). If **any** slide uses decorations, add `<link href="./_shared/decorations.css">` to `<head>`. See [references/decorations.md](references/decorations.md) for pseudo-element conflicts and combo suggestions.122123Rules:124125- **One core message per slide.** If you cannot summarize in one sentence, split it.126- **Fixed overhead:** Cover (1) + TOC (1) + Closing (1) = 3 slides minimum before content.127- **Cover slide must be minimal.** Only: title, subtitle (optional), speaker name (optional), date (optional). Do NOT add stats cards, KPI numbers, feature lists, or any other information blocks. The cover exists solely to set the tone and introduce the topic.128- **Closing slide must be minimal.** Only: a short closing phrase (e.g. "Thank You", "谢谢") and optionally one brief sentence summarizing the deck's message. Do NOT add cards, feature grids, bullet lists, CTA buttons, or any substantive content. The closing exists solely to signal the end.129- **Section dividers are mandatory for 6+ body slides.** Preceding each major chapter/topic with a `section-divider` slide helps the audience follow the narrative structure. Plan dividers into the Narrative Arc table — they count toward total slide count.130- Reading only the titles should tell the whole story.131- Max 1–2 animations per slide. Prefer `fade-up` as safe default; use dramatic/FX sparingly.132133#### 1B. Visual Elements Inventory134135List every visual asset with a **specific** tag. This section is **asset-level, not slide-level**: one row = one concrete asset or asset slot. If one slide contains multiple visuals, repeat the slide number with suffixes like `6a`, `6b`, `6c`. Use `[none]` only for slides that truly have no visual asset at all.136137<br />138139```140| # | Visual | Tag | Notes |141|---|---|---|---|142| 1 | — | [none] | Cover — text only |143| 3 | Hero illustration | [GenerateImage] | Abstract shapes, 1920×1080 |144| 4 | Revenue bar chart | [ECharts:chart-bar-echarts] | Q1–Q4 data |145| 5 | Architecture diagram | [Built-in] | 3-layer microservice, use arch-diagram layout |146| 6a | Card 1: customer interview portrait | [GenerateImage] | 4:3, natural indoor lighting |147| 6b | Card 2: product usage close-up | [GenerateImage] | 4:3, clean desk scene |148| 6c | Card 3: team workshop moment | [GenerateImage] | 4:3, collaborative office setting |149| 7 | User flow sankey | [ECharts:chart-sankey] | Signup → Activation |150| N | — | [none] | Closing — text only |151```152153Tags:154155- `[none]` — no visual (text-only slides)156- `[Built-in]` — CSS-only graphics, icons, emoji157- `[ECharts:<template>]` — exact template name: `chart-bar-echarts`, `chart-line-echarts`, `chart-pie-echarts`, `chart-radar-echarts`, `chart-sankey`, `chart-heatmap`, `chart-tree`, `chart-graph`158- `[GenerateImage]` — AI-generated illustrations/backgrounds (recommended)159- `[External]` — stock photos, logos, downloaded assets160161Rules:162163- **Do not collapse multiple assets on the same slide into one row.** A 3-card image slide needs 3 inventory rows.164- **Match asset count to layout slots.** `image-caption-card` usually needs 3 images; `image-grid` can need up to 7; `image-text-split` usually needs 1.165- **Only use** **`[none]`** **when the slide is genuinely text-only or built entirely from built-in shapes/icons.**166167### Step 2: Choose Theme168169Use `references/themes.md`. When in doubt:170171- **Engineers** → `catppuccin-mocha` / `tokyo-night` / `dracula` / `indigo-code`172- **Designers / product** → `editorial-serif` / `aurora` / `soft-pastel` / `fuchsia-cyan`173- **Execs** → `minimal-white` / `corporate-clean` / `swiss-grid` / `navy-formal`174- **Consumers** → `xiaohongshu-white` / `sunset-warm` / `soft-pastel`175- **Cyber / CLI / infra** → `terminal-green` / `blueprint` / `gruvbox-dark`176- **Pitch / bold** → `neo-brutalism` / `pitch-deck-vc` / `bauhaus` / `indigo-mint`177- **Launch / product reveal** → `glassmorphism` / `aurora`178- **Academic** → `academic-paper` / `editorial-serif` / `scholar-teal`179- **Party / government** → `crimson-gold` / `crimson-night`180- **Training / edu** → `navy-formal` / `scholar-teal` / `alert-crimson` / `indigo-code`181- **Finance / data** → `ledger-dark` / `amber-purple` / `arctic-cool`182- **Luxury / brand** → `luxury-noir` / `warm-cafe` / `japanese-minimal`183- **Nature / eco** → `forest-gold` / `clean-teal`184185Wire as `<link id="theme-link" href="./_shared/themes/NAME.css">` and list 3-5 alternatives in `data-themes`.186187#### Aesthetic Direction188189Design each deck as a **specific visual world**, not a generic AI-generated slide theme.190191- **Create atmosphere and depth.** Don't default to flat solid-color backgrounds when the concept calls for more. Use contextual textures and effects such as gradient meshes, SVG noise, geometric patterns, layered transparencies, dramatic shadows, decorative borders, grain overlays, or custom cursors when they strengthen the concept.192- **Avoid generic AI aesthetics.** Do not fall back to overused font families (`Inter`, `Roboto`, `Arial`, generic system UI stacks), cliched color recipes (especially purple gradients on white), predictable SaaS blocks, or cookie-cutter card grids that ignore the topic's context.193- **Interpret creatively.** Make unexpected but coherent choices that feel designed for the subject matter, audience, and tone. No two decks should converge on the same aesthetic by default.194- **Vary the design language across generations.** Deliberately explore different light/dark directions, typography pairings, textures, framing devices, and visual rhythms. Do not repeatedly converge on the same familiar choices such as `Space Grotesk`.195- **Match implementation complexity to the vision.** Maximalist directions should earn their richness with more elaborate code, layering, and motion. Minimalist or refined directions should earn their elegance through restraint, spacing, typography, and subtle details.196197#### Background Texture (`--bg-texture`)198199Every `.slide` supports a `--bg-texture` CSS variable that layers a subtle texture/gradient **above** the solid `--bg` color. Many themes ship a default texture (radial glows, SVG noise, etc.); slides that don't set it fall back to `none` (plain color, same as before).200201- **Per-slide override** — use inline `style` to change or disable texture on a single slide:202 ```html203 <!-- disable texture on this slide -->204 <section class="slide" style="--bg-texture: none;">205 <!-- custom gradient on this slide only -->206 <section class="slide" style="--bg-texture: radial-gradient(circle at 50% 50%, rgba(255,100,50,.1), transparent 60%);">207 ```208- **AI-generated background image** — for hero/statement slides, use the `image-fullbleed` layout template which provides a full-screen background image + dark overlay for text readability. Reference the generated image from `assets/`:209 ```html210 <!-- image-fullbleed template: full-screen bg + overlay -->211 <section class="slide" style="background: linear-gradient(rgba(0,0,0,.55), rgba(0,0,0,.55)), url('assets/cityscape_1024x576.png') center/cover;">212 ```213214### Step 3: Image Acquisition215216Use images **deliberately** — not every slide needs one. Refer to the Visual Elements Inventory (Step 1B) for which specific assets need images. When an inventory row is tagged `[GenerateImage]`, **generate that asset directly with GenerateImage**.217218#### Workflow2192201. **Decide which inventory items need generated images** based on the Visual Elements Inventory. List only the `[GenerateImage]` rows, noting for each:221 - A descriptive prompt (what the image should depict)222 - Purpose: background, hero image, supporting illustration, or icon223 - Desired aspect ratio (16:9 for full-bleed backgrounds, 4:3 for content areas, 1:1 for headshots)224 - Target slide slot if needed (e.g. `6a left card`, `6b middle card`, `6c right card`)2252. **Generate images with GenerateImage** — call GenerateImage directly (no subagent needed). Generate each asset one by one, saving them to the deck's `assets/` directory:226 - Write a detailed, specific prompt for each image describing the desired scene, style, color tones, and mood.227 - Choose the right `image_size` for the target aspect ratio:228 - `landscape_16_9` (2560×1440) — full-slide backgrounds, wide layouts229 - `landscape_4_3` (2240×1680) — content area illustrations230 - `square` (1920×1920) — headshots, profile images, square icons231 - `portrait_4_3` (1680×2240) — portrait232 - `portrait_16_9` (1440×2560) — tall portrait233 - Save as `assets/{name}_{w}x{h}.png` (e.g. `assets/hero_16x9.png`)234 - **Never merge multiple** **`[GenerateImage]`** **rows from one slide into a single output file.**2353. **Use the file paths** in your slide HTML:236 ```html237 <img src="assets/hero_1024x576.png" alt="Hero illustration">238 ```239240#### Prompt Tips for GenerateImage241242- **Be specific about style**: "a modern flat illustration of…" or "a photorealistic aerial view of…"243- **Include color guidance**: "using warm tones of terracotta and sage green" to match the slide palette244- **Describe composition**: "left side shows X, right side shows Y, with negative space in the center for text overlay"245- **Specify mood**: "professional, clean, and minimal" vs "vibrant, energetic, and bold"246- **Avoid text in images**: Generated text is often garbled — use HTML text elements instead247248#### Guidelines249250- **Specify dimensions.** Always choose the right `image_size` for the target aspect ratio.251- **Save to the deck's** **`assets/`** **directory.** All images use `{name}_{w}x{h}.png` naming so they can be referenced by path and inlined correctly.252- **Match the deck's color palette.** Include the primary/accent colors in your GenerateImage prompt so images feel cohesive with the slides.253- **Prefer illustration style for consistency.** AI-generated photos can look uncanny — illustrations, abstract art, and stylized graphics tend to produce better results.254255#### Other Asset Types256257- **Data charts** — use ECharts templates (`templates/single-page/chart-*.html`), no need to pre-generate images258259See [references/image-generation.md](references/image-generation.md) for detailed guidance on all asset types.260261### Step 4: Build HTML2622631. Scaffold the deck directory:264265 **Linux / macOS:**266 ```bash267 bash ./scripts/new-deck.sh my-talk <workspace-dir>268 ```269270 **Windows (native PowerShell):**271 ```powershell272 pwsh -File ./scripts/new-deck.ps1 my-talk <workspace-dir>273 ```274275 This creates `<workspace-dir>/my-talk/` with:276 ```277 my-talk/278 ├── my-talk.html ← product HTML (references ./_shared/ and ./assets/)279 ├── assets/ ← generated images, chart JS280 └── _shared/ ← minimal shared assets (pre-populated)281 ├── base.css282 ├── fonts.css283 ├── decorations.css284 ├── runtime.js285 ├── echarts.min.js286 ├── echarts-theme-sync.js287 ├── animations/288 │ ├── animations.css289 │ ├── fx-runtime.js290 │ └── fx/ ← copy needed fx scripts here291 └── themes/ ← copy needed theme CSS here292 ```2932942. Copy the chosen theme into `_shared/themes/`:295 ```bash296 cp <skill-dir>/assets/themes/<theme>.css <workspace-dir>/my-talk/_shared/themes/297 ```2983. Pick layouts from `templates/single-page/` per slide in plan.md2994. Copy `<section class="slide" data-deck-label="...">…</section>` blocks, replace demo data3005. For charts, copy from ECharts templates (`chart-*-echarts.html`, `chart-sankey.html`, etc.)301 - In the generated deck, use `./_shared/echarts.min.js` and `./_shared/echarts-theme-sync.js` (NOT the `../../assets/` paths from template source files)3026. Add `data-anim` / `data-fx` animations sparingly; copy needed fx scripts:303 ```bash304 cp <skill-dir>/assets/animations/fx/<effect>.js <workspace-dir>/my-talk/_shared/animations/fx/305 ```3067. Add decorations: if plan.md has any `deco-*` entries, uncomment `<link href="./_shared/decorations.css">` in `<head>`, then add matching classes to each `<section class="slide deco-xxx">`3078. Add `<div class="notes">…</div>` for speaker notes3089. Place generated images and chart JS in `assets/`309310⚠️ **Every HTML file must include the following meta tags in `<head>`:**311```html312<meta name="x-content-type" content="presentation" />313<meta name="x-presentation-version" content="1.0" />314<meta name="x-presentation-indicator" content="deck-stage .slide" />315```316The scaffold already includes these. If you create additional HTML files in the same deck folder, add all three meta tags to each one.317318### Step 5: Deliver319320**Do NOT preview or validate.** The model must NOT start a local server, open the HTML in a browser, or run any verification step. The deck is built directly in the user's workspace — no separate deploy step is needed.321322After completing the HTML, inform the user of:323- **Folder location:** `<workspace-dir>/my-talk/`324- **Entry file:** `my-talk.html`325- **Keyboard controls:**326 - `→` / `Space` / `Enter`: Next slide327 - `←`: Previous slide328 - `F` or `F11`: Toggle fullscreen mode329- **Recommend fullscreen** for the best presentation experience330331332## Authoring rules (important)333334- **Always start from a template.** Don't author slides from scratch.335- **Design for a distinctive aesthetic.** Make slides feel purpose-built for the topic, not like a generic AI deck.336- **Use tokens, not literal colors.** Good: `color: var(--text-1)`. Bad: `color: #111`.337- **Make backgrounds do real design work.** Use textures, overlays, shadows, borders, and atmospheric layers when they improve the concept; don't rely on plain fills by default.338- **Avoid default AI taste.** Skip overused font stacks, cliched purple-on-white gradients, and predictable SaaS-card layouts unless the brief explicitly demands them.339- **Vary themes and typography across decks.** Do not repeatedly converge on the same fonts, light/dark balance, or visual motifs.340- **Scale code complexity to the aesthetic.** Rich visual directions may require richer HTML/CSS/animation systems; restrained designs should show precision rather than emptiness.341- **ECharts always use SVG renderer.** `echarts.init(el, null, { renderer: 'svg' })` for crisp vector output.342- **Register ECharts to theme sync.** `window.__deckECharts.register(chart, getColorOption)` for T-key support.343- **Don't invent new layout files.** Prefer composing existing ones.344- **Keyboard-first.** Always include `<script src="./_shared/runtime.js"></script>`.345- **Wrap all slides in `<deck-stage width="1920" height="1080">`** — this is the deck boundary and canvas size declaration. Never use `<div class="deck">`.346- **One** **`.slide`** **per logical page.** `runtime.js` makes `.slide.active` visible.347- **Every `.slide` must have `data-deck-label`** — the page title for structural identification (e.g. `data-deck-label="项目进展"`).348- **Supply notes.** Wrap in `<div class="notes">…</div>` inside each slide.349- **NEVER put presenter-only text on the slide itself.** Use `.notes` div.350- **Use** **`deco-*`** **classes for atmosphere.** Don't inline atmosphere CSS — use `decorations.css` instead.351- **NEVER override** **`.slide`** **positioning.** `base.css` sets `.slide { position: absolute; opacity: 0 }` so `runtime.js` can show one page at a time via `.active`. Adding `position: relative` (or any override to `position`/`opacity`/`display` on `.slide`) in your `<style>` will break the slide system and cause all pages to stack visibly on one scroll. If you need layout tweaks, scope them to a child element inside `.slide`.352- **Use direct-child selectors for sizing in nested layouts.** When setting fixed `height`/`width` on `.card` (or any reusable class) inside a grid wrapper, always use `>` (e.g. `.my-grid > .card { height: 500px }`) to avoid accidentally sizing nested children. The base `.card` class is used at multiple nesting levels — a descendant selector like `.wrapper .card` will cascade into inner grids and cause layout overflow/misalignment.353354## Writing guide355356See [references/authoring-guide.md](references/authoring-guide.md) for the357step-by-step walkthrough.358359## Catalogs (load when needed)360361- [references/slide\_best\_practices/](references/slide_best_practices/) — 32 presentation-type best practices (narrative structure, language style, content depth). **Load in Step 1.**362- [references/themes.md](references/themes.md) — all 52 themes with when-to-use.363- [references/layouts.md](references/layouts.md) — all 56 layout types (48 original + 8 ECharts).364- [references/animations.md](references/animations.md) — 27 CSS + 20 canvas FX animations.365- [references/decorations.md](references/decorations.md) — 12 ambient decoration effects (`deco-*` classes).366- [references/presenter-mode.md](references/presenter-mode.md) — 演讲者模式 + 逐字稿编写指南.367- [references/image-generation.md](references/image-generation.md) — GenerateImage guide.368- [references/authoring-guide.md](references/authoring-guide.md) — full workflow.369370## File structure371372```373html-deck/374├── SKILL.md (this file)375├── references/ (detailed catalogs, load as needed)376├── assets/377│ ├── base.css (tokens + primitives — do not edit per deck)378│ ├── fonts.css (webfont imports)379│ ├── runtime.js (keyboard + presenter + overview + theme cycle + edit mode)380│ ├── echarts.min.js (ECharts 5.5.0 — local bundle, no CDN)381│ ├── echarts-theme-sync.js (ECharts ↔ CSS theme auto-sync)382│ ├── decorations.css (12 ambient decoration effects)383│ ├── themes/*.css (52 token overrides, one per theme)384│ └── animations/385│ ├── animations.css (27 named CSS entry animations)386│ ├── fx-runtime.js (auto-init [data-fx] on slide enter)387│ └── fx/*.js (20 canvas FX modules)388├── templates/389│ ├── deck.html (minimal 6-slide starter — reference only)390│ ├── theme-showcase.html (52 slides, iframe-isolated per theme)391│ ├── layout-showcase.html (iframe tour of all layouts)392│ ├── animation-showcase.html (FX + CSS animation slides)393│ └── single-page/*.html (56 layout files — 48 original + 8 ECharts)394├── scripts/395│ ├── new-deck.sh (scaffold a deck directory — Linux/macOS)396│ └── new-deck.ps1 (scaffold a deck directory — Windows native PowerShell)397```398399### Deck output structure (created by new-deck.sh)400401```402<workspace-dir>/<name>/403├── <name>.html ← product HTML with x-content-type meta tags404├── assets/ ← generated images, chart JS405│ ├── *.png406│ └── *.js407└── _shared/408 ├── base.css409 ├── fonts.css410 ├── decorations.css411 ├── animations/412 │ ├── animations.css413 │ ├── fx-runtime.js414 │ └── fx/*.js415 ├── themes/416 │ └── *.css417 ├── runtime.js418 ├── echarts.min.js419 └── echarts-theme-sync.js420```421422423## License & author424425MIT. Copyright (c) 2026.
tomjiu