All communication with the user MUST be in Japanese. Questions, confirmations, progress updates, and any other messages — always use Japanese.
Generate HTML files forming a complete presentation deck. Each file is a self-contained HTML document rendered at 1280 x 720 px. All content is pure HTML + CSS. Chart.js is used automatically when data visualizations require it (line charts, radar charts, etc.) — no other JavaScript is permitted.
For DOM snippets and component patterns, see references/patterns.md. For user-provided custom templates, see references/templates/.
Workflow Overview
| Phase | Name | Description |
|---|---|---|
| 0 | Template detection and loading | Check templates/ and decide between template mode or normal mode |
| 1 | Hearing | Confirm slide requirements with questions according to the mode |
| 2 | Design decision | Finalize color palette, fonts, and icons |
| 3 | Designing the slide structure | Plan the role and layout pattern of each slide |
| 4 | HTML generation | Output all slides as 001.html through NNN.html |
| 5 | index.html generation | Output a viewer with navigation and a print-ready page |
| 6 | Checklist confirmation | Verify compliance with constraints and quality standards |
| 7 | PPTX conversion (optional) | Convert to PowerPoint with the /pptx skill |
Phase 0: Template detection and loading
Before starting the hearing, check references/templates/ for user-provided HTML template files.
0-1. Template detection
Scan references/templates/ for both subdirectories and loose .html files.
- Subdirectories — each subdirectory is treated as a separate template set (e.g.,
templates/navy-gold/,templates/modern-tech/) - Loose HTML files —
.htmlfiles directly underreferences/templates/are treated as a single template set named "default" - Image directories — check each template set for an
images/subdirectory (e.g.,templates/navy-gold/images/). If found, these images are available as template assets
If nothing is found (no subdirectories and no HTML files) → proceed to Phase 1 in Normal mode.
0-2. Template selection
If templates are found, present them to the user and ask which to use.
When multiple template sets (subdirectories) exist:
"The following custom templates were found. Which template would you like to use? Please select by number."
- {directory-name-1}/({N} files)
- {directory-name-2}/({N} files)
- Do not use (create in normal mode)
- 1 or 2 (directory number) → that directory's HTML files become the template set. Proceed to 0-3
- 3 (Do not use) → proceed to Phase 1 in Normal mode
When a single template set exists (one subdirectory, or loose HTML files only):
"The following custom templates were found. Would you like to use one? Please select by number."
{file1.html}, {file2.html}, ...
- Yes — use this template
- No — do not use (create in normal mode)
- 1 → proceed to 0-3
- 2 → proceed to Phase 1 in Normal mode
0-3. Template loading
Read the selected template files and extract:
- Color palette (CSS custom properties / Tailwind classes)
- Font pair (primary JP + accent Latin)
- Header/footer structure and style
- Decorative elements and visual motifs
- Layout patterns used
- Template images — parse
<img>tags in each template HTML and catalog:srcpath, positioning attributes (position,z-index,width,height), and parent element location- Inferred role based on attributes:
- Background image (Background) —
position: absolute+ low z-index (0 or below) + large size (width > 400px or height > 400px) - Logo (Logo) — small size + located in header/footer region + appears across multiple slides
- Content image (Content) — all other images (main content area, medium size)
- Background image (Background) —
- Which slide type (Cover / Agenda / Content / Closing) uses each image
- Also scan the template's
images/subdirectory to identify available image assets not referenced in HTML
Proceed to Phase 1 in Template mode.
Cautions
- Mandatory Constraints still apply. Even if a custom template uses
<table>or non-CDN assets, the generated output must follow all rules in the Mandatory Constraints section below. Extract only the visual design (colors, fonts, spacing, decorative style) — not non-compliant implementation details. - Slide size must remain 1280x720px. Ignore any different dimensions in custom templates.
- Do not copy text content. Custom templates are style references only. All text content comes from Phase 1 hearing.
- Maximum 5 template files per set. If a template set contains more than 5 HTML files, read only the first 5 (sorted alphabetically) to limit context usage. Warn the user that remaining files were skipped.
- Supported formats: HTML and images. Image files (
.jpg,.png,.webp,.svg) within the template'simages/subdirectory are included as template assets. Other non-HTML files (PDFs, etc.) are ignored.
Phase 1: Hearing
Before generating any files, ask the user questions to capture intent. All questions must be asked in Japanese.
Important rules:
- One question per turn: Ask only one question per message. Wait for the user's answer before asking the next question.
- Number selection: All questions with predefined options must be presented as numbered lists. The user answers by entering the number only. Questions requiring free text input (directory path, title, company name, etc.) are the exception.
The hearing questions differ depending on the mode determined in Phase 0.
Template mode (template available)
When custom templates were loaded in Phase 0, skip all design-related questions and ask only the following:
- Output directory — same as 1-1 below
- Source of slide content — same as 1-4 below
- Presentation title — same as 1-5 below
- Number of slides — same as 1-6 below
- Company name / brand name — same as 1-7 below
- Confirmation of template design — present the extracted design (colors, fonts, decorative style) to the user and ask:
"The following design was detected from the template."
- Color: {extracted colors}
- Font: {extracted fonts}
- Header/Footer: {extracted structure}
"What would you like to do with this design? Please select by number."
- Use as is
- Want to change part of it
- 1 → Finalize the template design as is in Phase 2
- 2 → Ask which items to change (colors, fonts, etc.) and partially override the template design
Normal mode (no template)
Ask all of the following questions (1-1 through 1-9).
1-1. Output directory
"Please select the output directory. Answer by number or enter the path directly."
- Default (
output/slide-page{NN}/)- Specify a path
- 1 → use
output/slide-page{NN}/(NN = next sequential number based on existing directories) - 2 → follow up by asking for the path (text input)
- Direct path input → if the user directly types a path instead of a number, use that path
1-2. Style selection
"Please select a style. Answer by number."
- Creative — Bold color scheme, decorative elements, gradients, playful layout
- Elegant — Calm palette (gold tones), serif-leaning typography, generous whitespace
- Modern — Flat design, vivid accent colors, sharp edges, tech-oriented
- Professional — Navy/gray tones, structured layout, higher information density
- Minimalist — Few colors, extreme whitespace, typography-driven, minimal decoration
1-3. Theme Selection
"Please select a theme. Answer with a number."
- Marketing — Product announcements, campaign proposals, market analysis
- Portfolio — Case studies, track record introductions, portfolios
- Business — Business plans, management reports, strategy proposals, investor pitches
- Technology — SaaS introductions, technical proposals, DX promotion, AI/data analysis
- Education — Training materials, seminars, workshops, internal study sessions
1-4. Source of Slide Content
Ask the user how they want to provide the content for the slides. This determines what text, data, and structure will appear in the deck.
"How will you provide the slide content? Answer with a number."
- Reference file — Specify a file (Markdown, text, Word, etc.)
- Direct input — Enter text in the chat
- Topic only — Specify only the theme and have Claude generate the content
When a reference file is provided:
- Read the entire file
- Extract the logical structure (headings, sections, bullet points, data)
- Map the structure to the slide sequence — each major section becomes a section divider + content slides
- Preserve key text, numbers, and data points faithfully
- Adapt the content to fit the slide format (concise bullet points, not full paragraphs)
When direct text is provided:
- Organize the text into a logical presentation flow
- Ask clarifying questions if the structure is ambiguous
When only a topic is given:
- Ask about the target audience (executives, engineers, clients, etc.)
- Ask about key messages or points the user wants to convey
- Generate content based on the answers
1-5. Presentation title
Ask for the presentation title. Skip if already clear from the content source in 1-4.
1-6. Number of Slides
"Please select the number of slides. Answer with a number."
- 10 slides
- 15 slides
- 20 slides (recommended)
- 25 slides
- Automatic (determine the optimal number based on content)
- 5 (Automatic) Criteria for when is selected:
- Reference file: count the major sections/headings → each section ≈ 1 divider + 2-3 content slides, plus cover/agenda/summary/closing
- Direct text: estimate from the volume and structure of the provided text
- Topic only: default to 15-20 based on topic complexity
- When 5 is selected, inform the user of the determined count before proceeding (e.g., "内容から判断して18枚で作成します。よろしいですか?")
1-7. Company Name/Brand Name
Ask for the company or brand name to display in the header/footer.
1-8. Color Preferences
"Do you have any color preferences? Answer with a number."
- Leave it to you (automatically suggested based on style × theme)
- I want to specify (enter color codes or color names in the next question)
- 1 → auto-suggest based on the selected style × theme combination
- 2 → follow up by asking for specific color codes or color names (text input)
1-9. Use of Background Images
"Will you use background images? Answer with a number."
- Do not use (CSS gradients only)
- Use (specify images in the next question)
- 1 → no background images (CSS gradients only)
- 2 → follow up by asking the user to provide or approve specific images
Phase 2: Design Decision
Determine the following before generating any HTML:
Template mode
If custom templates were loaded in Phase 0:
- Color palette — use the palette extracted from the template (or with user-requested modifications from Phase 1)
- Font pair — use the fonts extracted from the template (or with user-requested modifications from Phase 1)
- Brand icon (1 Font Awesome icon)
If the user confirmed the template design as-is in Phase 1, present a brief summary and proceed. If the user requested partial changes, apply those changes and present the updated design for confirmation.
Normal mode
Based on Phase 1 hearing results, determine:
- Color palette (3-4 custom colors)
- Font pair (1 Japanese + 1 Latin)
- Brand icon (1 Font Awesome icon)
Present the design decisions to the user for confirmation before proceeding.
Proven Palette Examples
| Template | Style | Primary Dark | Accent | Secondary | Fonts |
|---|---|---|---|---|---|
| 01 Navy & Gold | Elegant | #0F2027 |
#C5A065 |
#2C5364 |
Noto Sans JP + Lato |
| 02 Casual Biz | Professional | #1f2937 |
Indigo | #F97316 |
Noto Sans JP |
| 03 Blue & Orange | Professional | #333333 |
#007BFF |
#F59E0B |
BIZ UDGothic |
| 04 Green Forest | Modern | #1B4332 |
#40916C |
#52B788 |
Noto Sans JP + Inter |
| 05 Dark Tech | Creative | #0F172A |
#F97316 |
#3B82F6 |
Noto Sans JP + Inter |
Phase 3: Slide Structure Design
Plan the full deck structure before writing any HTML. This phase produces a slide map.
3-1. Required Slides (All Decks)
| Position | Type | Pattern | Category |
|---|---|---|---|
| First | Cover | Center | cover |
| Second | Agenda | HBF | agenda |
| Second to last | Summary | HBF | conclusion |
| Last | Closing | Full-bleed / Center | conclusion |
3-2. Section Dividers by Slide Count
| Slides | Section Dividers | Content Slides |
|---|---|---|
| 10 | 2 | 4 |
| 15 | 3 | 8 |
| 20 | 4 | 12 |
| 25 | 5 | 16 |
3-3. Build the Slide Map
For each slide, determine:
- File number (
001.html,002.html, ...) - Type (Cover / Agenda / Section Divider / Content / Summary / Closing)
- Layout pattern (from the 43 patterns — see Phase 4 reference)
- Content summary (what text/data goes on this slide)
Rules:
- Never use the same layout pattern for 3 or more consecutive slides
- Match content from Phase 1-3 (reference file / text / topic) to appropriate slide types
- Use good variety across the 43 layout patterns
- Chart.js auto-detection: For slides with data visualizations, decide whether to use Chart.js or CSS-only based on the "When to Use Chart.js vs CSS-Only" table in references/patterns.md. Mark Chart.js slides in the slide map. CSS-only and Chart.js charts can coexist in the same deck
3-4. Standard Composition for 20 Slides (Reference)
| File | Type | Pattern | Purpose |
|---|---|---|---|
001.html |
Cover | Center | Title, subtitle, presenter, date |
002.html |
Agenda | HBF | Numbered section list |
003.html |
Section Divider 1 | Left-Right Split | Section 1 introduction |
004.html |
Content | HBF + Top-Bottom Split | Challenges vs. solutions + KPI |
005.html |
Content | HBF + 2-Column | Comparison / contrast |
006.html |
Section Divider 2 | Left-Right Split | Section 2 introduction |
007.html |
Content | HBF + 3-Column | 3-item cards |
008.html |
Content | HBF + Grid Table | Competitive comparison table |
009.html |
Content | HBF + 2x2 Grid | Risk analysis / SWOT |
010.html |
Section Divider 3 | Left-Right Split | Section 3 introduction |
011.html |
Content | HBF + N-Column | Process flow |
012.html |
Content | HBF + Timeline/Roadmap | Quarterly roadmap |
013.html |
Content | HBF + KPI Dashboard | KPI cards + CSS bar chart |
014.html |
Section Divider 4 | Left-Right Split | Section 4 introduction |
015.html |
Content | HBF + Funnel | Conversion funnel |
016.html |
Content | HBF + Vertical Stack | Architecture / org chart |
017.html |
Content | HBF + 3-Column | Strategy / policy (3 pillars) |
018.html |
Content | HBF + 2-Column | Detailed analysis / data |
019.html |
Summary | HBF | Key takeaways + next actions |
020.html |
Closing | Full-bleed / Center | Thank-you slide + contact info |
Phase 4: HTML Generation
Generate all slide HTML files based on the slide map from Phase 3.
4-0. Copying Template Images (Template Mode Only)
If the selected template contains an images/ subdirectory:
- Copy the template's
images/directory to{output_dir}/images/ - All subsequent HTML generation must reference template-derived images using the same relative paths (e.g.,
images/bg_cover.jpg)
Skip this step in 通常モード or when the template has no images.
4-1. For Each Slide
- Use the HTML Boilerplate (below)
- Apply the design decisions from Phase 2 (colors, fonts, icon)
- Use the layout pattern assigned in Phase 3
- Fill in the content from Phase 1-3 (reference file / text / generated)
- If the slide is marked "Chart.js" in the slide map: use Chart.js
<canvas>patterns from references/patterns.md (Chart.js Patterns section). Include the Chart.js CDN<script>in<head>and initialization<script>before</body> - Template images (template mode only): if template images were cataloged in Phase 0, reproduce the template's image placement:
- Cover / Closing slides → place background images (
bg_*) using the same positioning as the template (absolute, low z-index, matching dimensions) - All content slides → place logo images in the header/footer region matching the template's layout
- Slide-type matching → use the image set associated with each slide type from the Phase 0 catalog (e.g., Cover uses
bg_cover.*, Agenda usesbg_agenda.*) - Reference images via relative path
images/{filename}(copied in step 4-0)
- Cover / Closing slides → place background images (
- Save as
{output_dir}/{NNN}.html(zero-padded: 001.html, 002.html, ...)
HTML Boilerplate
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="utf-8" />
<meta content="width=device-width, initial-scale=1.0" name="viewport" />
<title>{Slide Title}</title>
<link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet" />
<link href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6.4.0/css/all.min.css" rel="stylesheet" />
<link href="https://fonts.googleapis.com/css2?family={PrimaryFont}:wght@300;400;500;700;900&family={AccentFont}:wght@400;600;700&display=swap" rel="stylesheet" />
<!-- Chart.js (only on slides marked "Chart.js" in Phase 3) -->
<!-- <script src="https://cdn.jsdelivr.net/npm/chart.js"></script> -->
<style>
body { margin: 0; padding: 0; font-family: '{PrimaryFont}', sans-serif; overflow: hidden; }
.font-accent { font-family: '{AccentFont}', sans-serif; }
.slide { width: 1280px; height: 720px; position: relative; overflow: hidden; background: #FFFFFF; }
/* Custom color classes: .bg-brand-dark, .bg-brand-accent, .bg-brand-warm, etc. */
</style>
</head>
<body>
<div class="slide {layout-classes}">
<!-- Content -->
</div>
<!-- Chart.js initialization (only on slides that contain charts) -->
<!-- <script> new Chart(...) </script> -->
</body>
</html>
Chart.js CDN inclusion rules:
- Only uncomment the
<script src="...chart.js...">line on slides marked "Chart.js" in the Phase 3 slide map - Only add the Chart.js CDN to slides that actually contain a
<canvas>chart — do not include it on every slide - The
<script>for Chart initialization must be placed just before</body>, after the slide<div> - Each chart
<canvas>must have a uniqueidattribute
43 Layout Patterns
Use one pattern per slide. For full DOM trees and component snippets, see references/patterns.md.
| # | Pattern | Root classes | When to use |
|---|---|---|---|
| 1 | Center | flex flex-col items-center justify-center |
Cover, thank-you slides |
| 2 | Left-Right Split | flex with w-1/3 + w-2/3 |
Chapter dividers, concept + detail |
| 3 | Header-Body-Footer | flex flex-col with header + flex-1 + footer |
Most content slides (default) |
| 4 | HBF + 2-Column | Pattern 3 body with two w-1/2 |
Comparison, data + explanation |
| 5 | HBF + 3-Column | Pattern 3 body with grid grid-cols-3 |
Card listings, 3-way comparison |
| 6 | HBF + N-Column | Pattern 3 body with grid grid-cols-{N} |
Process flows (max 5 cols) |
| 7 | Full-bleed | relative with absolute inset-0 layers |
Impact covers (CSS gradient default) |
| 8 | HBF + Top-Bottom Split | Pattern 3 body with flex flex-col two sections |
Content top + KPI/summary bar bottom |
| 9 | HBF + Timeline/Roadmap | Pattern 3 body with timeline bar + grid grid-cols-4 |
Quarterly roadmaps, phased plans |
| 10 | HBF + KPI Dashboard | Pattern 3 body with KPI grid + flex-1 chart area |
KPI cards + chart/progress visualization |
| 11 | HBF + Grid Table | Pattern 3 body with flex-based rows (w-1/N) |
Feature comparison, competitive analysis |
| 12 | HBF + Funnel | Pattern 3 body with decreasing-width centered bars | Conversion funnel, sales pipeline |
| 13 | HBF + Vertical Stack | Pattern 3 body with stacked full-width cards + separators | Architecture diagrams, layered systems |
| 14 | HBF + 2x2 Grid | Pattern 3 body with grid grid-cols-2 (2 rows) |
Risk analysis, SWOT, feature overview |
| 15 | HBF + Stacked Cards | Pattern 3 body with vertically stacked full-width cards + numbered badges | FAQ, Q&A, numbered key points, interview summary |
| 16 | HBF + TAM/SAM/SOM | Pattern 3 body with description list + nested circles or horizontal bars | Market size visualization (2 variants) |
| 17 | Chapter Divider | flex with w-1/4 dark + w-3/4 light (no HBF) |
Chapter/section dividers with large number |
| 18 | HBF + Contact | Pattern 3 body with w-1/2 message + w-1/2 contact card |
Contact info, CTA slides |
| 19 | HBF + 5-Column Process | Pattern 3 body with grid grid-cols-5 + optional RACI box |
5-step process flows, methodology |
| 20 | HBF + VS Comparison | Pattern 3 body with two cards + central VS badge | Head-to-head competitor comparison |
| 21 | Section End / Summary | flex flex-col with numbered key points + accent border |
Section closing, key takeaways |
| 22 | Table of Contents | flex flex-col with numbered agenda items + active highlight |
Agenda, table of contents |
| 23 | HBF + 2×3 Grid | Pattern 3 body with grid grid-cols-3 grid-rows-2 |
6-element overview, feature grid |
| 24 | HBF + Icon List | Pattern 3 body with icon circles + text rows | Feature lists, benefit highlights |
| 25 | HBF + Image Header Panel | Pattern 3 body with image-topped cards | Visual category cards |
| 26 | HBF + Emphasis Panel | Pattern 3 body with left-border accent panels | Key message emphasis, callouts |
| 27 | Glass Panel (Dark) | relative dark bg + backdrop-blur glass panels |
Premium dark-theme content |
| 28 | HBF + Gradient Panel | Pattern 3 body with gradient-bg panels | Highlighted content sections |
| 29 | HBF + Card Layout with Image | Pattern 3 body with icon + description cards | Service/product feature cards |
| 30 | Right-Side Background Image | flex with text left + image right (w-2/5) |
Text + supporting image |
| 31 | Quote Slide | flex flex-col items-center justify-center with large quotation marks |
Inspirational quotes, testimonials |
| 32 | Multiple Images Split | flex with multiple image panels side by side |
Photo gallery, visual comparison |
| 33 | Statistics Emphasis | Pattern 3 body with large stat numbers + labels | KPI highlights, data callouts |
| 34 | Center Message | flex flex-col items-center justify-center with single message |
Key statement, transition message |
| 35 | Q&A Slide | Centered large "Q&A" text with subtitle | Question & answer session |
| 36 | Question Slide | Centered question mark with audience prompt | Audience engagement, reflection |
| 37 | Movie / Book Quote | flex with dark accent bar + quote + attribution |
Famous quotes, literary references |
| 38 | HBF + Inline Image | Pattern 3 body with image + numbered text items | Image-supported explanations |
| 39 | HBF + Statistics Ratio | Pattern 3 body with vertical bar chart comparison | Ratio visualization, benchmarks |
| 40 | HBF + Text + Stats Panel | Pattern 3 body with text block + stat cards | Mixed narrative + data |
| 41 | Summary Glass Vertical | Dark bg + vertical glass panels with key points | Premium summary, dark-theme recap |
| 42 | HBF + Simple List + Supplement | Pattern 3 with bullet list (60%) + supplement panel (40%) | Lists with additional context |
| 43 | HBF + Case Study | Pattern 3 with challenge → solution → result flow | Company case studies, success stories |
Heading Convention
Bilingual: small English label above, larger Japanese title below.
<p class="text-xs uppercase tracking-widest text-gray-400 mb-1 font-accent">Market Analysis</p>
<h1 class="text-3xl font-bold text-brand-dark">市場分析</h1>
Number Emphasis Convention
Large digits + small unit span:
<p class="text-4xl font-black font-accent">415<span class="text-sm font-normal ml-1">M</span></p>
Phase 5: index.html Generation
After all slide HTML files are generated, create {output_dir}/index.html — a presentation viewer with keyboard navigation, viewport scaling, fullscreen, and PDF export.
Use the template at references/index-template.html as the base. Replace the placeholders:
{{TITLE}}→ presentation title from Phase 1<!-- {{SLIDES}} -->→ one<div>per slide:
<div class="slide-frame"><iframe src="001.html"></iframe></div>
<div class="slide-frame"><iframe src="002.html"></iframe></div>
<!-- ... repeat for all slides ... -->
Viewer Features
| Feature | How it works |
|---|---|
| Keyboard nav | → ↓ Space = next, ← ↑ = prev, F = fullscreen |
| Click nav | Click on deck area = next slide |
| Nav buttons | Prev / Next / PDF / Fullscreen (bottom-right overlay) |
| Slide counter | 01 / 20 format (bottom-left) |
| Viewport scaling | transform: scale() to fit any window size |
| PDF export | window.print() with @media print (all slides visible, page breaks) |
| Print scale | URL param ?print-scale=120 for custom print size |
Important
- The viewer shows one slide at a time (iframe toggle via
.is-activeclass) - In print mode, all slides are shown with
break-after: page - No external dependencies — the viewer is self-contained vanilla JS + CSS
Phase 6: Checklist Verification
After Phase 4 and Phase 5 are complete, verify the following. Fix any issues before delivering to the user.
- All files use identical CDN links
- Custom colors defined identically in every
<style> - Root is single
<div>under<body>withoverflow: hidden(only sibling allowed: Chart.js<script>on chart slides) - Slide size exactly 1280 x 720
- No external images (unless user approved or bundled with template)
- No JavaScript except Chart.js on chart slides (no other
<script>tags allowed) - All files for the chosen slide count are present
- Font sizes follow hierarchy
- Consistent header/footer on content slides
- Page numbers increment correctly
-
Confidentialin footer - Decorative elements use low z-index and low opacity
- File naming: zero-padded 3 digits (
001.html,002.html, ...) - Text uses
<p>/<h*>(not<div>) - No visible text in
::before/::after - No one-off colors outside palette
- Content density guidelines followed
-
index.htmlgenerated with iframes for all slides + navigation engine
Phase 7: PPTX Conversion (Optional)
After all checks pass, ask the user in Japanese:
"HTML slide generation is complete. Would you like to convert to PowerPoint (PPTX)?"
If the user declines, the workflow ends here.
Prerequisite Check
Before invoking the pptx skill, verify it is available by checking the list of available skills in the current session. The pptx skill will appear in the system's skill list if installed.
If the pptx skill is NOT available, inform the user and provide installation instructions:
/pptxA skill is required, but it is not currently installed.You can install it with the following command:
claude install-skill https://github.com/anthropics/claude-code-agent-skills/tree/main/skills/pptxAfter installation, in a new session, run
/pptxand specify the output directory{output_dir}.
Then end the workflow. Do not attempt conversion without the pptx skill.
Chart.js Slides and PPTX Conversion
When the deck contains Chart.js <canvas> charts (determined in Phase 3):
- Chart slides require screenshot-based conversion. The pptx converter cannot parse
<canvas>elements rendered by JavaScript. Chart.js charts will be captured as raster images (PNG) and embedded in the PPTX slide - Non-chart elements remain editable. Text, icons, and CSS-only elements on the same slide are still extracted as native PPTX objects
- Inform the pptx skill which slides contain Chart.js so it can apply the screenshot fallback selectively
Invocation (pptx skill available)
If the pptx skill is available, invoke /pptx using the Skill tool. Pass the following context:
- Source directory — the output path containing all
NNN.htmlfiles - Slide count — total number of HTML files
- Presentation title — from Phase 1 hearing
- Color palette — the 3-4 brand colors chosen in Phase 2
- Font pair — primary (JP) and accent (Latin) fonts
Example invocation prompt for the Skill tool:
Convert the HTML slide deck in {output_dir} to a single PPTX file.
- {N} slides (001.html through {NNN}.html)
- Title: {title}
- Colors: {primary_dark}, {accent}, {secondary}
- Fonts: {primary_font} + {accent_font}
- Chart.js slides: {list of slide numbers, e.g., "004, 013" or "none"}
- Output: {output_dir}/presentation.pptx
Important: Do not attempt HTML-to-PPTX conversion yourself. Always delegate to the /pptx skill, which has its own specialized workflow, QA process, and conversion tools.
Reference: Mandatory Constraints
| Rule | Value |
|---|---|
| Slide size | width: 1280px; height: 720px |
| CSS framework | Tailwind CSS 2.2.19 via CDN |
| Icons | Font Awesome 6.4.0 via CDN |
| Fonts | Google Fonts (1 JP primary + 1 Latin accent) |
| Language | lang="ja" |
| Root DOM | <body> -> single wrapper <div> (only sibling allowed: Chart.js <script> on chart slides) |
| Overflow | overflow: hidden on root wrapper |
| External images | None by default. Exception: images bundled with a selected template (images/ subdirectory) are automatically approved and copied to the output directory. Other external images require explicit user approval |
| JavaScript | Forbidden by default. Exception: Chart.js is used automatically when data visualizations require it (see Phase 3 auto-detection). No other JS libraries permitted |
| Custom CSS | Inline <style> in <head> only; no external CSS files |
PPTX Conversion Rules (Critical)
These directly affect PPTX conversion accuracy. Always follow.
- Prefer
<p>over<div>for text (tree-walkers may miss<div>text) - Never put visible text in
::before/::after - Separate decorative elements with
-z-10/z-0 - Max DOM nesting: 5-6 levels
- Font Awesome icons in
<i>tags (converter detectsfa-on<i>) - Use flex-based tables over
<table> linear-gradient(...)supported; complex multi-stop may fall back to screenshotbox-shadow,border-radius,opacityall extractable- Chart.js
<canvas>elements are not parseable by DOM tree-walkers → require screenshot fallback for PPTX. Prefer CSS-only charts when PPTX editability is a priority
Anti-Patterns (Avoid)
- Purposeless wrapper
<div>s (increases nesting) - One-off colors outside the palette
<table>for layout- Inline styles that Tailwind can replace
- Text in
::before/::after <div>for text (use<p>,<h1>-<h6>)
Reference: Design Guidelines
Color Palette
Define 3-4 custom colors as Tailwind-style utility classes in <style>:
| Role | Class Example | Purpose |
|---|---|---|
| Primary Dark | .bg-brand-dark |
Dark backgrounds, titles |
| Primary Accent | .bg-brand-accent |
Borders, highlights, icons |
| Warm/Secondary | .bg-brand-warm |
CTAs, emphasis, badges |
| Body text | Tailwind grays | Body, captions |
Keep palette consistent across all slides. No one-off colors.
Font Pair
| Role | Examples | Usage |
|---|---|---|
| Primary (JP) | Noto Sans JP, BIZ UDGothic | Body, headings |
| Accent (Latin) | Lato, Inter, Roboto | Numbers, English labels, page numbers |
Set primary on body; define .font-accent for the accent font.
Font Size Hierarchy
| Purpose | Tailwind class |
|---|---|
| Main title | text-3xl - text-6xl + font-bold/font-black |
| Section heading | text-xl - text-2xl + font-bold |
| Card heading | text-lg + font-bold |
| Body text | text-sm - text-base |
| Caption/label | text-xs |
Content Density Guidelines
| Element | Recommended Max |
|---|---|
| Bullet points | 5-6 |
| Cards per row | 3-4 |
| Body text lines | 6-8 |
| KPI boxes | 4-6 |
| Process steps | 4-5 |