Create visually compelling presentations that follow the AWS reInvent 2023 design system.
Every slide should look like it was crafted by the AWS brand team.
Gather requirements: Ask the user for topic, key messages, and target audience
Plan slide structure: Outline slide titles and content types before writing any code
Generate background images: Run the gradient background generator script
Create slides: Use PptxGenJS (Node.js) with the AWS theme constants
Add SVG visuals: Generate SVG diagrams for architecture/flow slides and embed as images
Apply animations: Design contextual animations and apply via apply_animations.py
QA (two-phase): QA uses two complementary layers — programmatic validation
catches what rendered images hide (out-of-bounds shapes, font violations),
then visual inspection catches what code cannot judge (aesthetics, readability).
Phase 1 — Programmatic QA (fast, deterministic, run in main agent):
python3 scripts/qa_validate.py output.pptx
If critical issues are found (exit code 1), fix them before proceeding to Phase 2.
Phase 2 — Visual QA (kiro preferred, subagent fallback): Delegates image-heavy
inspection to a separate context to protect the main context window. Prefer kiro
CLI (Opus 4.6) for higher quality analysis with severity classification. If kiro
is not available, fall back to a subagent (Sonnet 4.6+).
# Step 1: Generate AWS gradient backgrounds
python3 scripts/create_aws_slide.py backgrounds --output-dir /tmp/myslide-assets/
# Step 2: Run the PptxGenJS creation script (generated per presentation)
node create_presentation.js
# Step 3: Apply animations (design JSON spec per presentation context)
python3 scripts/apply_animations.py output.pptx animations.json -o animated.pptx
# Step 4: Programmatic QA — catches structural issues renderers hide
python3 scripts/qa_validate.py output.pptx
# Step 5: Visual QA — prefer kiro (Opus 4.6), fall back to subagent (see below)
B. Editing an Existing Slide
When the user says "change slide 3" or "update the title slide":
Identify which slide(s) to modify
Read the current slide content (markitdown + image inspection)
Apply targeted changes (text, colors, layout, or visual elements)
Re-render and verify only the affected slides
C. Sub-Agent Strategy for Large Decks (8+ slides)
For presentations with many slides, use parallel sub-agents to maximize throughput.
Each sub-agent handles an independent group of slides.
Parallelization pattern:
Agent 1: Title + Section Header slides (structural)
Agent 2: Content slides (odd-numbered)
Agent 3: Content slides (even-numbered)
Agent 4: SVG diagram generation for all visual slides
# Sub-agent prompt template:
Generate slides [N] through [M] for the AWS presentation.
- Use the AWS theme from references/aws-theme.md
- Background images are at: /tmp/myslide-assets/
- Save individual slide JS snippets to: /tmp/myslide-parts/slide-{N}.js
- Follow the layout pattern specified for each slide type.
After all sub-agents complete, combine the JS snippets into one PptxGenJS script and execute.
Slide Types
Each presentation should use a MIX of these layouts. Never repeat the same layout more than twice in a row.
Type
When to Use
Reference
Title
First slide (single speaker)
slide-patterns.md > Title Slide
Title (Two Speakers)
First slide (co-presentation)
slide-patterns.md > Two-Speaker Title
Agenda
Second slide, table of contents
slide-patterns.md > Agenda Slide
Section Header
Chapter dividers (01, 02...)
slide-patterns.md > Section Header
Content Card
Key points with icon
slide-patterns.md > Content Card
Two Column Card
Side-by-side options/concepts
slide-patterns.md > Two Column Card
Three Column
Comparisons, 3 options
slide-patterns.md > Three Column
Process Flow
User scenarios, step-by-step flows
slide-patterns.md > Process Flow
Comparison Table
Option comparisons, feature matrices
slide-patterns.md > Comparison Table
Architecture
System diagrams
slide-patterns.md > Architecture
Venn/Comparison
Overlapping concepts
slide-patterns.md > Venn Diagram
Screenshot+Text
Demo/console walkthrough
slide-patterns.md > Screenshot
Summary Grid
2x2 key takeaways
slide-patterns.md > Summary Grid
Evolution/Progression
Maturity stages, AI evolution
slide-patterns.md > Evolution
Multi-Card Grid
2x2 or 3x2 feature cards
slide-patterns.md > Multi-Card Grid
Gradient Border Cards
Light cards with colored borders on dark bg
slide-patterns.md > Gradient Border Cards
Image Hero
Topic intro with generated visual
slide-patterns.md > Image Hero
Image + Text Split
Concept with illustration
slide-patterns.md > Image + Text Split
Full Image Background
Impactful quotes, key messages
slide-patterns.md > Full Image Background
Thank You
Last slide
slide-patterns.md > Thank You
SVG Visual Elements
For slides that need diagrams, architecture visuals, or flowcharts, generate inline SVG and
convert to PNG for embedding. This dramatically improves visual quality over plain text slides.
When to generate SVGs:
Architecture or system flow explanations
Process/workflow diagrams
Comparison charts or feature matrices
Any slide where the content is inherently visual
SVG generation approach:
# Generate SVG with official AWS service icons, convert to PNG for embedding
python3 scripts/create_aws_slide.py svg-diagram \
--type architecture \
--elements "CloudFront,API Gateway,Lambda,Bedrock,S3" \
--output /tmp/myslide-assets/arch-diagram.png
Available icon names (use these as element names for automatic icon embedding):
Lambda, EC2, S3, DynamoDB, API Gateway, CloudFront, Bedrock, ECS, EKS, RDS,
Aurora, VPC, ELB, Route 53, CloudWatch, IAM, Cognito, SNS, SQS, Step Functions,
EventBridge, Kinesis, SageMaker, Redshift, Athena, Glue, KMS, WAF, Shield,
Fargate, ECR, AppSync, OpenSearch, ElastiCache, Secrets Manager, ACM, and 200+ more.
See icons/ directory for the full list of available service icons.
Alternatively, craft SVG inline in the Node.js script and use sharp to convert to PNG base64.
Diagram Type Selection for Presentations
Presentations almost always need High-Level diagrams (logical grouping), not Infrastructure diagrams (VPC/Subnet).
Presentation Context
Diagram Type
Key Characteristics
Executive briefing, sales pitch
High-Level
Hub-spoke layout, generic containers, no VPC/Subnet
Technical deep-dive, Well-Architected review
Infrastructure
VPC/AZ/Subnet nesting, security boundaries
Platform overview (e.g., AgentCore, EKS)
High-Level (Hub-Spoke)
Central runtime + radiating spoke services
Event-driven / microservices overview
High-Level
EventBridge as central bus, producers left, consumers right
High-Level Architecture Pattern (Hub-Spoke)
For presentation slides, the hub-spoke pattern is most effective:
Central service (Bedrock, EventBridge, EKS) at the center of the diagram
Spoke services radiate outward with clear directional arrows
Logical grouping using generic container (dashed border) instead of VPC/Subnet
Observability (CloudWatch, X-Ray) at the bottom, separated from main flow
No AWS Cloud outer container -- cleaner for slides
Multi-directional arrows -- not just left-to-right; use top/bottom/left/right freely
Arrows must NEVER pass through another service box. This is the #1 architecture
diagram defect. Before drawing each arrow, trace the path from source to target and
verify no intermediate box lies in the way. If one does:
Route around: Use two LINE segments (L-shape or Z-shape) to go around the box
Move the blocking box to a row/column that clears the path
Connect via the intermediate box if there's a logical flow through it
Arrow segments must maintain >= 10px clearance from any icon bounding box
In hub-spoke layouts, radial arrows must not cross sibling spokes -- stagger spoke y-positions
Validation: After all elements are placed, mentally trace every arrow and confirm
it does not cross any box. See slide-patterns.md > Arrow Routing Rules for code examples.
aws-diagram Skill Integration
For complex architecture diagrams (VPC nesting, orthogonal arrows, 8+ services), use the
aws-diagram skill instead of create_aws_slide.py. It produces native PPTX architecture slides
that can be merged into myslide decks:
SVG layer order rule (applies to all SVG diagram generation):
Icons must render ABOVE arrows. Render order: background > containers > arrows > callouts > icons.
Image Generation (Optional)
When a slide needs a conceptual illustration, hero image, or visual metaphor that cannot
be expressed with SVG diagrams or AWS icons, use the sd35l skill (GA) to generate images
via Amazon Bedrock. nova2-omni is also available as an alternative (gated preview).
Requires: The sd35l skill must be installed in the Claude Code environment.
When to Use Image Generation vs SVG Diagrams
Content Type
Use SVG/Icons
Use sd35l
AWS architecture diagrams
Yes
No
Process flows, step diagrams
Yes
No
Conceptual hero images (AI brain, cloud, etc.)
No
Yes
Abstract background visuals
No
Yes
Product/scenario illustrations
No
Yes
Screenshot placeholders
No
Yes
Data flow with service icons
Yes
No
Slide-Optimized Aspect Ratios
Use Case
Aspect Ratio
Slide Coverage
Full-slide background
16:9
Entire slide behind text
Hero image (title slide)
16:9
Right 60-70% of slide
Half-slide illustration
2:3 or 3:4
Left/right half
Card illustration
1:1
Inside a content card
Banner (wide strip)
21:9
Top or bottom strip
Integration Workflow
# 1. Generate image with sd35l (find skill path dynamically)
SD35L_SCRIPT=$(find ~/.claude/plugins -path "*/sd35l/scripts/generate_image.py" 2>/dev/null | head -1)
python3 "$SD35L_SCRIPT" \
--prompt "Abstract dark gradient with glowing neural network connections, deep navy and purple tones, futuristic technology atmosphere, minimal clean composition" \
--negative-prompt "text, watermarks, logos, people, bright colors, white background" \
--aspect-ratio 16:9 \
--seed 42 \
--output-dir /tmp/myslide-assets/
# 2. Result JSON: {"model": "...", "seed": 42, "images": ["/tmp/myslide-assets/sd35l_1.png"]}# 3. Embed in PptxGenJS using base64
All card-like shapes (content cards, agenda items, grid cells, tag badges, summary bars)
MUST use ROUNDED_RECTANGLE with rectRadius instead of plain RECTANGLE.
This gives a modern, polished look consistent with contemporary UI design.
Radius Guidelines
Element
rectRadius
Notes
Large cards (content, 2-col, 3-col)
0.10 - 0.12
Main content containers
Inner boxes (code blocks, option cards)
0.06 - 0.08
Nested within larger cards
Tag badges (effort/impact labels)
0.15
Pill-shaped badges
Progress bars
0.10
Pill-shaped bars
Summary/footer bars
0.08
Horizontal wide bars
Accent Styling with Rounded Corners
Do NOT overlay thin rectangular accent bars on ROUNDED_RECTANGLE shapes (they won't
align with corners). Instead, use line border property for accent colors:
Full-slide overlays (dark transparency over hero images)
Table cell backgrounds (must tile without gaps)
Decorative gradient accent bars at slide edges
Thin Accent Lines Under Titles (DO NOT USE)
Do NOT add thin orange/pink accent lines (h: 0.04) under slide titles.
This creates visual noise and looks repetitive across slides. The title text
itself is sufficient as the visual anchor. If visual separation is needed
between title and content, use whitespace (0.3"+ gap) instead of a line.
// ❌ WRONG: Thin accent line under title
slide.addShape("rect", {
x: 0.8, y: 1.05, w: 1.5, h: 0.04, fill: { color: C.orange },
});
// ✅ CORRECT: Use whitespace gap between title and content// Title at y: 0.33, content starts at y: 1.41 (natural 0.3"+ gap)
Color Discipline (CRITICAL)
Slides look more professional with fewer, well-chosen colors. Too many colors
create visual noise and distract from the message. Limit each slide to 5 core
colors maximum. A restrained palette feels intentional and polished; a rainbow
of colors feels chaotic.
The 5 Core Colors
Role
Color
HEX
When to use
Background
Deep Purple-Black
09051B
Slide background (via gradient image)
Primary Text
White
FFFFFF
All headings, body text, bullets
Emphasis
Orange
F66C02
Key terms, highlights, numbered badges
Container
Dark Navy
161E2D
Card fills, table cells, box backgrounds
Secondary
Light Slate
C8D0D8
Subtitles, descriptions, captions (readable on projectors)
Allowed Accent (sparingly)
C91F8A (Magenta) — card border lines only, max 1-2 per slide
5600C2 (Purple) — already in the gradient background, no need to add separately
Colors to AVOID in regular slides
These colors exist in the theme file for special cases but should NOT appear in
normal content slides. Using them creates a cluttered, inconsistent look:
FF28EF (Neon Pink) — only for section header numbers
ABABE3 (Lavender), FF9EA2 (Salmon Pink) — only for complex architecture diagrams
00A0C8 (Teal), 69AE35 (Green) — only when semantically meaningful (e.g., success/info)
010135, 02043B — only in multi-layer architecture diagrams
Rule of thumb: If you're about to use a 6th color, stop and ask whether one
of the 5 core colors can serve the same purpose.
Gradient Fills for Cards and Containers
PptxGenJS does not support native gradient fills on shapes. To create gradient
card backgrounds (e.g., a subtle dark-to-darker gradient inside a card), render
an SVG gradient rectangle and convert to PNG:
Use gradient fills sparingly — they add visual depth but overuse diminishes the effect.
One or two gradient cards per presentation is ideal.
Gradient Borders (for any shape)
Gradient borders work on any card — single Content Card, Multi-Card Grid,
or the Gradient Border Cards layout. The technique: render an SVG with a
gradient-filled rectangle and a smaller inner rectangle in the fill color,
creating a border effect.
See slide-patterns.md > Gradient Border Cards for the full multi-card layout pattern.
Typography Size Rules (CRITICAL)
Body text must NEVER be smaller than 15pt. This is the #1 visual quality issue.
Table cells, comparison columns, and process flow card text are NOT exceptions —
they must also be 15pt minimum. Only footer copyright and slide-number captions
may go below 15pt.
Minimum Font Size by Element
Element
Min Size (pt)
Recommended (pt)
Weight
Slide title
36
36-44
Bold/Heavy
Section number (01, 02)
36
36
Bold
Card title / Sub-header
20
20-24
Bold
Body text
15
16
Regular
Bullet items
15
15-16
Regular
Table cell text
15
15-16
Regular
Process flow card text
15
15-16
Regular
Three-column body
15
15-16
Regular
Caption / Footer / Copyright
8
8-10
Light
The only elements allowed below 15pt are:
Footer copyright text (8pt)
Slide number labels (8-10pt)
Service name labels under icons in architecture diagrams (10-12pt)
Everything else — including table cells, comparison columns, process flow
descriptions, multi-card grid body text — MUST be 15pt or higher. If content
overflows at 15pt, reduce the text content rather than shrinking the font.
Card-to-Text Balance Rule
Text should fill at least 60% of the card's vertical space. If a card has excessive
bottom whitespace (>30% empty), apply one or more of these fixes:
Increase font size (first choice) — bump body text to 16-18pt
Increase line spacing — use lineSpacingMultiple: 1.3 to 1.5
Reduce card height — shrink the card to fit the content snugly
Add vertical centering — use valign: "middle" on text boxes
// WRONG: Small text in large card = excessive whitespace
slide.addText(bodyText, {
x: 1, y: 2.5, w: 5, h: 3.5,
fontSize: 12, // TOO SMALL
});
// CORRECT: Properly sized text filling the card
slide.addText(bodyText, {
x: 1, y: 2.5, w: 5, h: 3.5,
fontSize: 16,
lineSpacingMultiple: 1.3,
valign: "top",
});
Grid/Multi-Card Slides
For 2x2 grids and 3-column layouts where space is tighter:
Card title: 18-20pt bold
Body text: 15pt minimum (never drop to 12-14pt)
Table cells: 15pt minimum (not 13-14pt — reduce column count or text instead)
Process flow card text: 15pt minimum
If content overflows, reduce text content rather than font size
Use paraSpaceAfter: 6 instead of paraSpaceAfter: 10 to reclaim space
Text Emphasis Rules
The AWS template uses specific color highlighting for emphasis:
Orange (F66C02): Primary emphasis for key terms, important concepts
Magenta (C91F8A): Secondary emphasis, links, interactive elements
White bold: Section headers within content areas
Regular white: Body text
Use rich text arrays in PptxGenJS to apply selective highlighting:
PptxGenJS doesn't natively support gradients on text or shape borders. Two workarounds
are documented in references/pptxgenjs.md:
Gradient Text (section "Gradient Text"): Render as SVG, convert to PNG via sharp,
embed as image. Good for large hero numbers like "80%".
Gradient Border (section "Gradient Border"): Post-process the generated PPTX with
python-pptx to inject OOXML gradient line XML. This is the preferred approach for shape
borders because the result is native PowerPoint and remains editable. Use apply_gradient_border()
from the reference.
Conversational Editing
The user may request changes like:
"3번 슬라이드 제목을 바꿔줘" → Read slide 3, modify title text
"아키텍처 다이어그램을 추가해줘" → Generate SVG + add new slide
"색상을 좀 더 밝게" → Adjust fill/text colors
"순서를 바꿔줘" → Reorder slides in presentation.xml
For each edit request:
Show the user what the current slide looks like (render to image)
Describe the proposed change
Apply the change
Show the result for confirmation
Animations (Contextual Design)
Animations are designed per-presentation based on content and narrative flow.
There are no fixed templates — each slide gets animations tailored to its story.
Design animations contextually after slides are created:
What appears first? (title, framing context)
What's the focal sequence? (data flow, process steps)
What's the conclusion? (output, call-to-action)
Write JSON spec describing the animation sequence per slide
Apply with script:
# List shapes to find target names/IDs
python3 scripts/apply_animations.py deck.pptx --list-shapes
# Apply animations
python3 scripts/apply_animations.py deck.pptx animations.json -o animated.pptx
Key Primitives
Category
Effects
Use Case
Entrance
appear, fade_in, fly_in, wipe, zoom_in
Revealing content step-by-step
Emphasis
pulse, spin, grow_shrink, color_pulse
Drawing attention to key element
Exit
disappear, fade_out, fly_out, zoom_out
Removing elements
Motion
motion_path (SVG path syntax)
Data flow, pipeline visualization
Property
property_change (fill_color, visibility)
State transitions
Triggers
Trigger
Behavior
onClick
New click point — presenter controls timing
withPrevious
Simultaneous with previous animation
afterPrevious
Auto-starts after previous completes
Shape Naming
PptxGenJS does NOT preserve custom name attributes. After generating the PPTX,
run --list-shapes to get actual shape names/IDs, then build the animation JSON spec
using those names.
Animation Design Principles
Less is more — animate only what serves the narrative
Consistent timing — use 500ms for standard, 300ms for fast, 800-1000ms for dramatic
Group related elements — card + text should animate together (withPrevious)
Build left-to-right — for pipelines and data flows
Fade for text, Fly for shapes — general heuristic for visual harmony
For very large or complex presentations, use the team-assemble pattern to coordinate
multiple agents working in parallel. This is more powerful than simple sub-agents because
it enables inter-agent communication, shared task tracking, and phased execution.
When to use Team-Up instead of Sub-Agents:
15+ slides with diverse content types
Presentations requiring research + design + implementation phases
When SVG diagram generation is complex and needs dedicated attention
Team Composition:
Agent
Role
Model
Responsibility
lead
Orchestrator
opus
Plan structure, assign tasks, final QA
designer
Visual Design
sonnet
Generate backgrounds, SVG diagrams, icons
writer-1
Content (slides 1-N/2)
sonnet
Write first half slide code
writer-2
Content (slides N/2+1-N)
sonnet
Write second half slide code
qa
Quality Assurance
opus/sonnet
Run qa_validate.py first, then visual QA via kiro (Opus) or subagent (Sonnet 4.6+)
Team Workflow:
1. lead: Analyze topic, create slide outline, assign tasks
2. designer + writer-1 + writer-2: Work in parallel
- designer generates all background/SVG assets
- writers create PptxGenJS code for assigned slides
3. lead: Combine all parts into single presentation script
4. qa: Run qa_validate.py, fix critical issues, then render and inspect visually
5. lead: Apply fixes, finalize
248 official AWS service icons (SVG, from AWS Architecture Icon Deck)
scripts/create_aws_slide.py
Generate AWS gradient backgrounds, SVG diagrams with official icons, logo
scripts/office/soffice.py
Convert PPTX to PDF via LibreOffice
scripts/office/unpack.py
Unpack PPTX to XML for direct editing
scripts/office/pack.py
Repack edited XML back to PPTX
scripts/thumbnail.py
Generate thumbnail grid for visual overview
scripts/clean.py
Clean PPTX XML (remove unused elements)
scripts/add_slide.py
Add slides to existing PPTX
scripts/apply_animations.py
Inject OOXML animations from JSON spec into PPTX
scripts/qa_validate.py
Programmatic QA — bounds, connectors, font sizes, zero-size shapes
references/image-generation-integration.md
sd35l / nova2-omni image generation guide for slides
Two-Phase QA (ALWAYS run both phases):
Phase 1 — Programmatic QA (run in main agent, fast):
python3 {skill_path}/scripts/qa_validate.py {pptx_path}
# Exit code 0 = pass, 1 = critical issues, 2 = error# Add --json for machine-readable output# Add --strict to include INFO-level findings
This catches what rendered images HIDE — shapes extending beyond slide boundaries,
connector endpoints outside the slide, text below 15pt, zero-size shapes. These
issues are invisible in rendered images because renderers clip at the slide edge.
Fix all critical issues before proceeding to Phase 2.
Visual QA is image-heavy and consumes significant context window tokens. Delegate
it to a separate context — never read slide images in the main agent.
Option A — Kiro CLI (preferred, Opus 4.6):
Kiro uses Opus 4.6 which produces more structured reports with severity
classification and deeper design system analysis. Use when kiro CLI is installed.
# First convert PPTX to images
python3 {skill_path}/scripts/office/soffice.py --headless --convert-to pdf {pptx_path}
pdftoppm -jpeg -r 150 {pdf_path} /tmp/myslide-qa/slide
# Then delegate visual QA to kiro
bash {kiro_skill_path}/scripts/run_kiro.sh --trust-all --timeout 300 \
"You are a visual QA inspector for AWS-themed PowerPoint presentations.
Read each slide image and inspect for visual quality:
$(for f in /tmp/myslide-qa/slide-*.jpg; do echo "- $f"; done)
Design system: dark bg (#09051B), white text, orange (#F66C02) emphasis,
dark navy (#161E2D) cards, rounded rectangles, body text min 15pt.
Phase 1 (programmatic) already verified: bounds, connectors, font sizes.
Focus on VISUAL quality only:
- Color contrast, orange highlight usage (max 2-3 per slide)
- Layout variety (no 3+ identical patterns), card whitespace (text >= 60%)
- SVG diagram clarity, icon layer order, arrow-icon clearance
- Thank You slide text overlap, generated image dark theme match
Per-slide report: PASS/FAIL with severity (경미/중간/심각) and specific issues.
Summary at end."
Option B — Subagent (fallback, Sonnet 4.6+):
Use when kiro is not available. Spawn a dedicated subagent for visual inspection.
You are a visual QA inspector for AWS-themed PowerPoint presentations.
Phase 1 (programmatic) already passed. Structural checks are verified.
Focus on VISUAL quality only.
1. Convert PPTX to images:
python3 {skill_path}/scripts/office/soffice.py --headless --convert-to pdf {pptx_path}
pdftoppm -jpeg -r 150 {pdf_path} {output_prefix}
2. Read each slide image and check:
- Color contrast sufficient (white on dark)
- Orange highlights used sparingly (max 2-3 per slide)
- Layout variety across deck (no 3+ identical patterns in a row)
- SVG diagrams render cleanly without text overlap
- Icons render above arrows (correct layer order)
- No arrow lines crossing over service icons
- Card whitespace ratio: text fills >= 60% of card height
- Thank You slide: English/Korean text not overlapping
- Generated images match dark theme (dark with accent glows)
- Text overlay on images has sufficient contrast
3. Return a text-only report:
- Per-slide: PASS or FAIL with specific issues
- Summary: total pass/fail count and critical issues to fix
Do NOT return images. Only return text findings.
