Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(image-references): add 14 new catalog entries across three dimensions

hugohe361f6bbd13f60
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.md
index f86c4244..8f105d1f 100644
--- a/skills/ppt-master/references/image-generator.md
+++ b/skills/ppt-master/references/image-generator.md
@@ -223,7 +223,7 @@ Write `project/images/image_prompts.json` with this shape:
| `deck_palette` | yes | Step 2 lock | Single palette name shared by all items |
| `color_scheme` | yes | `design_spec.md §III` | HEX triplet from Strategist |
| `items[].filename` | yes | `§VIII` resource list | Output filename with extension |
-| `items[].type` | yes | Step 3 per-image | One of: `background`, `hero`, `typography`, `infographic`, `flowchart`, `framework`, `comparison`, `timeline`, `scene` |
+| `items[].type` | yes | Step 3 per-image | One of: `background`, `hero`, `portrait`, `typography`, `infographic`, `flowchart`, `framework`, `matrix`, `cycle`, `funnel`, `pyramid`, `comparison`, `timeline`, `map`, `scene` |
| `items[].page_role` | yes | Step 3 per-image | `local` (default) or `full_page` (escape hatch only) |
| `items[].text_policy` | yes | Step 3 per-image | `none` (default for most) or `embedded` (rare) |
| `items[].aspect_ratio` | yes | Container sizing | Passed to `image_gen.py --aspect_ratio` |
diff --git a/skills/ppt-master/references/image-palettes/_index.md b/skills/ppt-master/references/image-palettes/_index.md
index 5b3780d2..ad1a88a0 100644
--- a/skills/ppt-master/references/image-palettes/_index.md
+++ b/skills/ppt-master/references/image-palettes/_index.md
@@ -6,7 +6,7 @@ A **palette** is the deck's **color behavior** — proportion, role, temperament
---
-## 1. Catalog (10 palettes)
+## 1. Catalog (14 palettes)
Each palette has its own file with: proportion rules, role assignments, temperament, fewshot snippets, what to avoid.
@@ -22,6 +22,10 @@ Each palette has its own file with: proportion rules, role assignments, temperam
| [`dark-cinematic`](./dark-cinematic.md) | Premium, atmospheric, low-light | Premium product / film / entertainment |
| [`duotone`](./duotone.md) | Two-color limited, poster-like | Cultural / cover hero / cinematic |
| [`nature-organic`](./nature-organic.md) | Earthy, natural, wellness | Environment / wellness / outdoor |
+| [`jewel-tone`](./jewel-tone.md) | Deep saturated gemstone — emerald/sapphire/ruby + gold | Luxury / fashion / premium product / heritage |
+| [`frost-ice`](./frost-ice.md) | Near-white field with pale cool accents | Health / medical / beauty / premium SaaS |
+| [`sunset-gradient`](./sunset-gradient.md) | Warm gradient flow (pink → orange → purple) | Lifestyle / creative / travel / event |
+| [`earthy-dusty`](./earthy-dusty.md) | Muted desaturated earth tones, Morandi-adjacent | Interior / wellness / mindfulness / slow living |
---
@@ -31,16 +35,21 @@ Match `design_spec.md d. Style` + `e. Color Scheme` content vibe. First match wi
| Content vibe / industry | Recommended palette | Alternates |
|---|---|---|
-| Consulting / finance / B2B / corporate | `cool-corporate` | `editorial-classic` |
+| Consulting / finance / B2B / corporate | `cool-corporate` | `editorial-classic`, `frost-ice` |
| Tech / SaaS / AI | `tech-neon` | `cool-corporate`, `dark-cinematic` |
+| Modern SaaS / fintech / health-tech | `frost-ice` | `cool-corporate`, `tech-neon` |
+| Health / medical / beauty / skincare | `frost-ice` | `nature-organic`, `earthy-dusty` |
| Education / training / onboarding | `macaron` | `warm-earth` |
| Methodology / Before-After / mindset shift | `mono-ink` | `editorial-classic` |
-| Personal / lifestyle / brand story | `warm-earth` | `nature-organic` |
-| Product launch / marketing / event | `vivid-launch` | `tech-neon` |
+| Personal / lifestyle / brand story | `warm-earth` | `nature-organic`, `earthy-dusty` |
+| Interior / wellness / mindfulness / slow living | `earthy-dusty` | `warm-earth`, `nature-organic` |
+| Product launch / marketing / event | `vivid-launch` | `tech-neon`, `sunset-gradient` |
+| Creative agency / travel / music / lifestyle | `sunset-gradient` | `vivid-launch`, `warm-earth` |
+| Luxury / fashion / jewelry / premium / heritage | `jewel-tone` | `dark-cinematic`, `editorial-classic` |
| Children / storybook | `macaron` | `warm-earth` |
-| Premium / entertainment / film | `dark-cinematic` | `duotone` |
+| Premium / entertainment / film | `dark-cinematic` | `jewel-tone`, `duotone` |
| Cultural / media / cover-art | `duotone` | `editorial-classic` |
-| Environment / wellness / outdoor | `nature-organic` | `warm-earth` |
+| Environment / wellness / outdoor | `nature-organic` | `warm-earth`, `earthy-dusty` |
| Finance / journalism / explainer | `editorial-classic` | `cool-corporate` |
| Government / formal | `cool-corporate` | `editorial-classic` |
@@ -50,24 +59,28 @@ Match `design_spec.md d. Style` + `e. Color Scheme` content vibe. First match wi
Some combinations clash. Use this matrix as a sanity check after auto-selection.
-| | cool-corp | warm-earth | tech-neon | editorial | macaron | mono-ink | vivid-launch | dark-cinem | duotone | nature-org |
-|---|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
-| vector-illustration | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ |
-| flat | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ |
-| 3d-isometric | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✓✓ | ✓✓ | ✗ | ✓ |
-| digital-dashboard | ✓✓ | ✗ | ✓✓ | ✓✓ | ✗ | ✓ | ✓ | ✓✓ | ✗ | ✗ |
-| corporate-photo | ✓✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ | ✓ | ✓✓ | ✗ | ✓✓ |
-| blueprint | ✓✓ | ✗ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ | ✓✓ | ✓ | ✗ |
-| editorial | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ |
-| sketch-notes | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✗ | ✓✓ |
-| ink-notes | ✓ | ✓ | ✗ | ✓✓ | ✗ | ✓✓ | ✗ | ✗ | ✓ | ✗ |
-| chalkboard | ✗ | ✓ | ✗ | ✗ | ✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ |
-| watercolor | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓✓ |
-| warm-scene | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✓✓ | ✓ | ✓✓ |
-| screen-print | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
-| fantasy-animation | ✗ | ✓✓ | ✗ | ✗ | ✓✓ | ✗ | ✓ | ✗ | ✗ | ✓✓ |
-| pixel-art | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✗ |
-| nature | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✗ | ✗ | ✓✓ |
+| | cool-corp | warm-earth | tech-neon | editorial | macaron | mono-ink | vivid-launch | dark-cinem | duotone | nature-org | jewel-tone | frost-ice | sunset-grad | earthy-dusty |
+|---|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
+| vector-illustration | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ |
+| flat | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
+| minimalist-swiss | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ |
+| glassmorphism | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
+| 3d-isometric | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✓✓ | ✓✓ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| digital-dashboard | ✓✓ | ✗ | ✓✓ | ✓✓ | ✗ | ✓ | ✓ | ✓✓ | ✗ | ✗ | ✗ | ✓✓ | ✗ | ✗ |
+| corporate-photo | ✓✓ | ✓✓ | ✓ | ✓✓ | ✗ | ✗ | ✓ | ✓✓ | ✗ | ✓✓ | ✓✓ | ✓ | ✗ | ✓✓ |
+| blueprint | ✓✓ | ✗ | ✓✓ | ✓ | ✗ | ✓✓ | ✗ | ✓✓ | ✓ | ✗ | ✗ | ✓ | ✗ | ✗ |
+| editorial | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ |
+| sketch-notes | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✗ | ✓✓ | ✗ | ✗ | ✗ | ✓ |
+| ink-notes | ✓ | ✓ | ✗ | ✓✓ | ✗ | ✓✓ | ✗ | ✗ | ✓ | ✗ | ✗ | ✓ | ✗ | ✓ |
+| chalkboard | ✗ | ✓ | ✗ | ✗ | ✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✓ |
+| paper-cut | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✗ | ✓✓ |
+| watercolor | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
+| warm-scene | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ |
+| screen-print | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| vintage-poster | ✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✗ | ✗ | ✓ | ✓✓ |
+| fantasy-animation | ✗ | ✓✓ | ✗ | ✗ | ✓✓ | ✗ | ✓ | ✗ | ✗ | ✓✓ | ✗ | ✗ | ✓ | ✗ |
+| pixel-art | ✗ | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| nature | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✗ | ✗ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ |
✓✓ recommended | ✓ acceptable | ✗ avoid
diff --git a/skills/ppt-master/references/image-palettes/earthy-dusty.md b/skills/ppt-master/references/image-palettes/earthy-dusty.md
new file mode 100644
index 00000000..8f300147
--- /dev/null
+++ b/skills/ppt-master/references/image-palettes/earthy-dusty.md
@@ -0,0 +1,91 @@
+# Palette: earthy-dusty
+
+Muted desaturated earth tones — dusty pink, sage green, faded terracotta, muted ochre. Calm, sophisticated, refined-minimal — Morandi-adjacent. Used for lifestyle / interior design / wellness / mindfulness / slow living / contemporary minimal brand decks where understatement is the visual signal.
+
+> This file describes **color behavior**, not HEX values. earthy-dusty tells the model how to apply the deck's HEX values **at reduced saturation** — every color appears slightly desaturated, even when the HEX itself is more vivid.
+
+---
+
+## 1. Temperament
+
+| Trait | Setting |
+|---|---|
+| Saturation | Low — all colors are dusted, faded, never vivid |
+| Brightness contrast | Soft — adjacent values, no harsh jumps |
+| Color count visible | 3-4 (all muted; no single color dominates loudly) |
+| Mood | Calm, refined, contemplative, slow, considered |
+| Material | Linen / clay / faded paint / soft fabric — natural and aged |
+
+---
+
+## 2. Proportion rule (50-35-15, all-muted)
+
+| Role | Share | HEX from `design_spec` | Behavior |
+|---|---|---|---|
+| Field | **45-55%** | `secondary` rendered as muted neutral (warm gray, faded cream, dusty taupe) | Calm field — never pure white |
+| Primary muted | **30-40%** | `primary` desaturated 20-40% from its source HEX | The dominant tone — still recognizable but dusted |
+| Accent muted | **10-15%** | `accent` desaturated similarly | The "loudest" element, but loud is relative — even the accent is dusty |
+
+> **Hard rule**: earthy-dusty applies a **uniform desaturation** to every color in the deck. Vivid HEX values get rendered as their dusted neighbors ("vivid coral `#FF6B6B` rendered as dusty rose `#D4A5A5`"). State this transformation in the prompt.
+
+---
+
+## 3. Role semantics
+
+- **Field** is the calm neutral backdrop — warm gray, oat, dusted cream
+- **Primary muted** carries gentle warmth — dusty rose, sage, faded clay
+- **Accent muted** is the "loudest" element but stays within dusty register — never breaks the palette discipline
+- All three colors should feel like they could share a room — no chromatic competition
+
+---
+
+## 4. How to phrase it in a prompt
+
+> "Color behavior is earthy-dusty Morandi-adjacent: every color appears desaturated 25-35% from its source HEX. Secondary muted oat `#E8E0D5` (slightly dusted from cream) carries about 50% of the canvas as calm field. Primary muted dusty rose `#D4A5A5` (a desaturated translation of the deck's primary) carries the main shape at about 35%. Accent muted sage `#A8B5A0` (desaturated translation of the accent) appears in one or two small dusty highlights totaling about 12%. No vivid color anywhere — even the accent is dusted. Refined, contemplative, slow."
+
+---
+
+## 5. Compatible renderings
+
+| Rendering | Notes |
+|---|---|
+| ✓✓ watercolor | Watercolor's muted material aligns naturally |
+| ✓✓ editorial | Magazine restraint pairs well with muted discipline |
+| ✓✓ corporate-photo | Photography graded toward dusty / Morandi palette (lifestyle, interior, wellness) |
+| ✓✓ flat | Muted flat geometric blocks |
+| ✓✓ vector-illustration | Dusty vector restraint |
+| ✓ paper-cut | Muted paper craft |
+| ✓ warm-scene | Warm scene with dusted grading |
+| ✗ tech-neon / vivid-launch / pixel-art / digital-dashboard | Wrong temperament — those rely on saturation |
+| ✗ chalkboard | Wrong material |
+
+---
+
+## 6. Fewshot prompt snippets
+
+**Snippet A — applied to an editorial lifestyle spread**
+
+> [...rendering paragraph...] Color behavior is earthy-dusty Morandi-adjacent: every color appears desaturated 30% from its source HEX. Secondary muted oat `#E8E0D5` carries the upper 60% of the canvas as calm field. Primary muted dusty terracotta `#C9A38C` (desaturated translation of the deck's primary) forms a confident block across the lower 30%. Accent muted sage `#A8B5A0` appears as one thin horizontal line near the meeting point and one small dusty dot in the upper right (totaling about 10%). No vivid color anywhere. Refined, contemplative. [...container guidance...]
+
+**Snippet B — applied to a watercolor wellness page**
+
+> [...rendering paragraph...] Color behavior is earthy-dusty: the watercolor wash flows in three muted bands — upper third muted oat `#E8E0D5` with gentle paper showing through, middle band dusty rose `#D4A5A5` (desaturated translation of the deck's primary), lower third muted sage `#A8B5A0`. Each color appears desaturated 30% from its source HEX, with soft natural color pooling at the boundaries. No vivid pigments. Slow, contemplative, refined-minimal. [...container guidance...]
+
+---
+
+## 7. Forbidden
+
+- Vivid / saturated colors anywhere (defeats Morandi discipline — switch to `warm-earth` for warm saturation, `nature-organic` for natural saturation)
+- Pure white or pure black (earthy-dusty uses dusted neutrals — even "white" should be oat or cream)
+- High-contrast pairings (adjacent muted values only)
+- More than 4 colors in the composition
+- Sharp ink outlines (defeats softness)
+
+---
+
+## 8. When to switch away
+
+- For warmer grounded saturation → `warm-earth`
+- For natural / outdoor saturation → `nature-organic`
+- For high-contrast methodology → `mono-ink`
+- For pastel softness with more chroma → `macaron`
diff --git a/skills/ppt-master/references/image-palettes/frost-ice.md b/skills/ppt-master/references/image-palettes/frost-ice.md
new file mode 100644
index 00000000..0873b364
--- /dev/null
+++ b/skills/ppt-master/references/image-palettes/frost-ice.md
@@ -0,0 +1,90 @@
+# Palette: frost-ice
+
+Near-white field with pale cool accents — icy blue, pale silver-gray, hint of crystalline. Clean, clinical, premium-minimal, calming. Used for health / medical / beauty / skincare / wellness / premium SaaS / B2B tech where serenity and clarity are the primary visual signal.
+
+> This file describes **color behavior**, not HEX values. frost-ice tells the model how to apply the deck's HEX values with **maximum breathing room and cool restraint**.
+
+---
+
+## 1. Temperament
+
+| Trait | Setting |
+|---|---|
+| Saturation | Very low — colors approach white asymptotically |
+| Brightness contrast | Soft — almost all light values, with one subtle deeper accent |
+| Color count visible | 2-3 (near-white field + pale cool + one slightly-deeper accent) |
+| Mood | Clean, calming, clinical, premium-minimal |
+| Material | Frosted glass / fresh snow / fine porcelain — never warm |
+
+---
+
+## 2. Proportion rule (80-15-5, near-white dominant)
+
+| Role | Share | HEX from `design_spec` | Behavior |
+|---|---|---|---|
+| Field / background | **75-85%** | `secondary` pushed toward near-white (`#F8FBFD` / `#F0F4F8` / `#FFFFFF`) | The vast calm field. Frost-ice's identity *is* this breathing room. |
+| Pale cool primary | **10-15%** | `primary` rendered as a pale cool tint (icy blue, pale silver, faint mint) | Subtle structure — visible but never assertive |
+| Accent / focal | **3-7%** | `accent` (often a slightly deeper cool — steel blue, polished silver) | The single moment of visual weight |
+
+> **Hard rule**: frost-ice keeps the field over 75% of the canvas. If structural elements push the field below 70%, the palette identity breaks — switch to `cool-corporate`.
+
+---
+
+## 3. Role semantics
+
+- **Field** carries serenity — it must feel vast, calm, almost empty. Frost-ice is defined by what *isn't* there.
+- **Pale cool primary** carries gentle structure — used for soft shapes, subtle dividers, faint geometry
+- **Accent** is the single focal moment — one small but deliberate visual anchor; never repeated
+
+---
+
+## 4. How to phrase it in a prompt
+
+> "Color behavior is frost-ice: secondary near-white `#F8FBFD` occupies about 80% of the canvas as vast calm field. Pale cool primary `#DBEAFE` appears as soft restrained structure (about 12%). Accent steel blue `#3B82F6` appears as one small deliberate focal element (about 5%). No warm tones, no saturated colors. The vast field is the identity — most of the canvas is breathing room."
+
+---
+
+## 5. Compatible renderings
+
+| Rendering | Notes |
+|---|---|
+| ✓✓ digital-dashboard | Clean clinical UI — natural pairing |
+| ✓✓ vector-illustration | Light vector with cool restraint |
+| ✓✓ flat | Pale flat geometric |
+| ✓✓ minimalist-swiss | Field-and-grid pairing |
+| ✓✓ glassmorphism | Soft polished cool aesthetic |
+| ✓ corporate-photo | Photography with cool clinical grading (medical, beauty, spa) |
+| ✓ blueprint | Pale schematic |
+| ✗ sketch-notes / chalkboard / fantasy-animation / pixel-art | Wrong temperament — those are warm |
+| ✗ dark-cinematic combinations | Dark mood is opposite of frost identity |
+
+---
+
+## 6. Fewshot prompt snippets
+
+**Snippet A — applied to a vector-illustration health/spa hero**
+
+> [...rendering paragraph...] Color behavior is frost-ice: secondary near-white `#F8FBFD` occupies about 80% of the canvas as vast calm field. A single soft pale cool primary `#DBEAFE` rounded shape appears in the lower third (about 12%). Accent steel blue `#3B82F6` appears as one small deliberate dot or thin line at a rule-of-thirds intersection (about 5%). No warm tones, no saturated colors. Maximum breathing room. [...container guidance...]
+
+**Snippet B — applied to a glassmorphism SaaS product showcase**
+
+> [...rendering paragraph...] Color behavior is frost-ice: near-white field `#F8FBFD` dominates (about 78%). The single frosted-glass panel uses a pale cool primary `#DBEAFE` tint at 50% opacity (about 14%). One small accent steel blue `#3B82F6` indicator inside the panel marks the focal data point (about 5%). Soft cool gradient background blurs through. The vast calm field outside the panel is the identity — premium-minimal clinical clean. [...container guidance...]
+
+---
+
+## 7. Forbidden
+
+- Saturated or warm colors anywhere (defeats frost identity)
+- Field below 70% of canvas
+- Multiple accent points (frost-ice allows exactly one focal moment)
+- Heavy outlines or dark text (visible inside the image — SVG text overlay handles labels)
+- Texture or noise (frost-ice is polished and clean, never tactile)
+
+---
+
+## 8. When to switch away
+
+- For warmth → `warm-earth` or `macaron`
+- For corporate confidence with deeper primary → `cool-corporate`
+- For atmospheric premium → `dark-cinematic`
+- For methodology / mindset → `mono-ink`
diff --git a/skills/ppt-master/references/image-palettes/jewel-tone.md b/skills/ppt-master/references/image-palettes/jewel-tone.md
new file mode 100644
index 00000000..5845993b
--- /dev/null
+++ b/skills/ppt-master/references/image-palettes/jewel-tone.md
@@ -0,0 +1,89 @@
+# Palette: jewel-tone
+
+Deep saturated gemstone colors — emerald, sapphire, ruby, amethyst, gold. Premium, luxurious, evening-elegant. Used for luxury / fashion / jewelry / premium product / evening events / heritage brands where richness is the visual signal.
+
+> This file describes **color behavior**, not HEX values. The deck's HEX triplet comes from `design_spec.colors`. jewel-tone tells the model how to apply those HEX values with **jewel-rich saturation discipline**.
+
+---
+
+## 1. Temperament
+
+| Trait | Setting |
+|---|---|
+| Saturation | High — gemstone richness; never washed-out |
+| Brightness contrast | Strong — deep jewels against dark or cream field |
+| Color count visible | 2-3 (one or two jewel colors + neutral field + small gold/silver accent) |
+| Mood | Premium, luxurious, sophisticated, evening-elegant |
+| Material | Velvet / silk / polished gemstone — implied richness, never plastic |
+
+---
+
+## 2. Proportion rule (50-35-15, jewel-rich)
+
+| Role | Share | HEX from `design_spec` | Behavior |
+|---|---|---|---|
+| Field / background | **45-55%** | `secondary` (often deep cream, dark navy, or near-black) | Sets the velvet stage for the jewels |
+| Primary jewel | **30-40%** | `primary` (one rich jewel — emerald, sapphire, ruby, amethyst) | The dominant gemstone color |
+| Accent (gold / silver / second jewel) | **10-15%** | `accent` | A metallic gold or a small second-jewel pop |
+
+> **Hard rule**: jewel-tone requires **high saturation** in `primary`. If the deck's primary HEX is muted, push toward its richest neighbor when describing it ("rich deep emerald `#047857`" not "muted teal").
+
+---
+
+## 3. Role semantics
+
+- **Primary jewel** carries the luxury statement — used in large confident blocks, never as tints or backgrounds
+- **Secondary field** is the velvet stage — cream, near-black, or deep neutral that lets the jewel sing
+- **Accent** is the metallic highlight — gold leaf, silver thread, polished brass — small but bright
+
+---
+
+## 4. How to phrase it in a prompt
+
+> "Color behavior is jewel-tone: rich primary deep emerald `#047857` carries the dominant gemstone block (about 35%); secondary deep cream `#FEF3C7` forms the velvet field (about 50%); accent gold `#D4AF37` appears as a thin polished metallic line or one small jewel-cut shape (about 12%). High saturation, premium feel. No muted tints. No additional colors."
+
+---
+
+## 5. Compatible renderings
+
+| Rendering | Notes |
+|---|---|
+| ✓✓ editorial | Magazine luxury — natural pairing |
+| ✓✓ corporate-photo | High-end product/lifestyle photography graded toward jewel tones |
+| ✓✓ dark-cinematic combinations are handled by `dark-cinematic` palette; jewel-tone is the *richer alternative* — use jewel-tone when you want saturation, dark-cinematic when you want atmospheric |
+| ✓ flat | Bold flat jewel blocks |
+| ✓ vector-illustration | Acceptable but loses material implication |
+| ✓ screen-print | Limited-color poster luxury |
+| ✗ sketch-notes / chalkboard / pixel-art / fantasy-animation | Wrong temperament |
+| ✗ digital-dashboard | Data UI conflicts with luxury |
+
+---
+
+## 6. Fewshot prompt snippets
+
+**Snippet A — applied to an editorial luxury hero**
+
+> [...rendering paragraph...] Color behavior is jewel-tone: rich primary deep emerald `#047857` forms a confident block across the lower 40% of the canvas with high saturation. Secondary deep cream `#FEF3C7` carries the upper 48% as velvet field. Accent gold `#D4AF37` appears as a single thin metallic horizontal line at the meeting point and one small polished gold dot in the upper right (totaling about 10%). No muted tints. No additional colors. Premium evening feel. [...container guidance...]
+
+**Snippet B — applied to a corporate-photo lifestyle product**
+
+> [...rendering paragraph...] Color grading is jewel-tone: image is graded toward rich primary ruby `#9A1B3A` as the dominant shadow tone, secondary deep cream `#FEF3C7` carries the highlight regions, and accent gold `#D4AF37` appears as warm metallic surfaces (a polished frame, a brass detail). The overall feel is high-saturation premium evening — no faded or washed-out tones. Like a contemporary luxury campaign shot. [...container guidance...]
+
+---
+
+## 7. Forbidden
+
+- Muted / washed-out / pastel tints (defeats jewel saturation — switch to `editorial-classic` or `warm-earth`)
+- Equal-share three-jewel palette (becomes a flag — keep one dominant jewel)
+- More than one metallic accent
+- Plastic or matte material feel (jewel-tone implies polished material)
+- Heavy black outlines (jewel-tone is fill-based, not line-based)
+
+---
+
+## 8. When to switch away
+
+- For atmospheric premium without saturation → `dark-cinematic`
+- For restrained corporate luxury → `editorial-classic`
+- For warm friendly brand → `warm-earth`
+- For methodology / mindset → `mono-ink`
diff --git a/skills/ppt-master/references/image-palettes/sunset-gradient.md b/skills/ppt-master/references/image-palettes/sunset-gradient.md
new file mode 100644
index 00000000..8c4235b4
--- /dev/null
+++ b/skills/ppt-master/references/image-palettes/sunset-gradient.md
@@ -0,0 +1,93 @@
+# Palette: sunset-gradient
+
+Warm gradient flow — pink → orange → purple, atmospheric and energetic. Used for lifestyle / creative agencies / travel / music / event / modern brand decks where mood and warmth carry the page. Distinguished by being the **one palette built around transitions**, not flat blocks.
+
+> This file describes **color behavior**, not HEX values. sunset-gradient tells the model how to apply the deck's HEX values **as gradient stops**, not as discrete fills.
+
+---
+
+## 1. Temperament
+
+| Trait | Setting |
+|---|---|
+| Saturation | Mid to high; smooth transitions, never harsh |
+| Brightness contrast | Continuous gradient — no sudden value jumps |
+| Color count visible | 2-3 stops blended; one optional accent break |
+| Mood | Atmospheric, energetic, warm, optimistic-romantic |
+| Material | Light + atmosphere — sunset sky, neon glow, soft radiance |
+
+---
+
+## 2. Proportion rule (gradient flow, not block proportions)
+
+| Role | Share | HEX from `design_spec` | Behavior |
+|---|---|---|---|
+| Gradient field | **80-90%** | `primary` → `secondary` → `accent` as stops | The entire canvas is a smooth blend; no hard color boundaries |
+| Accent break (optional) | **5-10%** | A single small shape in `accent` (or a contrasting cool color if all three HEX are warm) | One deliberate "rest" point in the gradient |
+| Negative shape (optional) | **5-10%** | Near-white or near-black silhouette cut from the gradient | Adds compositional anchor without breaking flow |
+
+> **Hard rule**: sunset-gradient requires **smooth blending** between stops. Discrete color blocks turn the palette into a flag — switch to `vivid-launch` or `duotone` for block compositions.
+
+---
+
+## 3. Role semantics
+
+- **Primary** is the warmest stop (often the deepest pink/red) — anchors the gradient's emotional core
+- **Secondary** is the middle stop (orange/peach/coral) — bridges the transition
+- **Accent** is the cool stop (purple/lavender/magenta) — closes the gradient at the opposite end
+- The **direction** of the gradient (horizontal / vertical / diagonal / radial) is a composition choice — pick the one that supports the slide's narrative weight
+
+---
+
+## 4. How to phrase it in a prompt
+
+> "Color behavior is sunset-gradient: smooth diagonal gradient flowing from primary deep pink `#EC4899` in the lower-left corner, transitioning through secondary warm orange `#F97316` across the middle band, into accent purple `#9333EA` in the upper-right corner. Smooth blending throughout — no hard color edges. Optional: one small near-white silhouette shape cuts from the gradient as a focal rest point (about 5% of canvas)."
+
+---
+
+## 5. Compatible renderings
+
+| Rendering | Notes |
+|---|---|
+| ✓✓ flat | Smooth gradient on flat geometry |
+| ✓✓ watercolor | Gradient is watercolor's native language |
+| ✓✓ warm-scene | Sunset-grade cinematic atmosphere |
+| ✓ vector-illustration | Acceptable but requires the gradient exception (vector-illustration normally bans gradients — sunset-gradient explicitly overrides for the background) |
+| ✓ glassmorphism | Soft cool gradient under glass panels (use a tame variant) |
+| ✓ 3d-isometric | Gradient sky behind isometric forms |
+| ✗ minimalist-swiss / blueprint / mono-ink | Wrong temperament |
+| ✗ pixel-art / sketch-notes / ink-notes / chalkboard | Wrong material |
+| ✗ corporate-photo | Photography uses real grading, not painted gradient |
+
+> **Override**: sunset-gradient is the palette that **forces a gradient** into the image. When the chosen rendering normally bans gradients (e.g. vector-illustration), the gradient applies to the **background field only**, while shapes on top remain flat per the rendering's rules.
+
+---
+
+## 6. Fewshot prompt snippets
+
+**Snippet A — applied to a flat lifestyle hero**
+
+> [...rendering paragraph...] Color behavior is sunset-gradient: smooth diagonal gradient flowing from primary deep pink `#EC4899` in the lower-left corner, transitioning through secondary warm orange `#F97316` across the middle band, into accent purple `#9333EA` in the upper-right corner. Smooth blending — no hard color edges. Above the gradient field, one stylized flat near-black silhouette of a stylized palm tree sits at the lower right as a focal rest point (about 6% of canvas). Atmospheric, energetic, optimistic. [...container guidance...]
+
+**Snippet B — applied to a warm-scene cinematic chapter divider**
+
+> [...rendering paragraph...] Color grading is sunset-gradient: the cinematic scene is graded as a real golden-hour sunset — sky transitions from primary deep coral `#FB7185` low on the horizon, through secondary warm amber `#F59E0B` in the middle altitudes, into accent deep purple `#7C3AED` in the upper atmosphere. Smooth atmospheric blending throughout. Optional: a small distant silhouette anchors the foreground. Warm, romantic, optimistic. [...container guidance...]
+
+---
+
+## 7. Forbidden
+
+- Discrete blocks of color (defeats gradient identity — switch to `vivid-launch` or `duotone`)
+- More than 3 gradient stops (becomes muddy)
+- Cool / neutral gradient (that's a different palette — sunset-gradient is warm-dominant)
+- Hard banding artifacts (gradient must be visually smooth)
+- More than one focal break (one rest point only)
+
+---
+
+## 8. When to switch away
+
+- For bold flat saturation → `vivid-launch`
+- For two-color limited → `duotone`
+- For warm grounded (no gradient) → `warm-earth`
+- For dark atmospheric → `dark-cinematic`
diff --git a/skills/ppt-master/references/image-renderings/_index.md b/skills/ppt-master/references/image-renderings/_index.md
index ff642acb..552d76d4 100644
--- a/skills/ppt-master/references/image-renderings/_index.md
+++ b/skills/ppt-master/references/image-renderings/_index.md
@@ -6,7 +6,7 @@ A **rendering** is a visual style family: line quality, texture, depth, material
---
-## 1. Catalog (16 renderings)
+## 1. Catalog (20 renderings)
Each rendering has its own file with: style paragraph, container sizing guidance, fewshot prompt snippets, what to avoid. **Read only the file for the rendering you pick** — never glob the directory.
@@ -16,6 +16,8 @@ Each rendering has its own file with: style paragraph, container sizing guidance
|---|---|---|
| [`vector-illustration`](./vector-illustration.md) | Clean flat vector with bold shapes, no gradients | Consulting / SaaS / general professional decks |
| [`flat`](./flat.md) | Modern geometric blocks, slightly more design-forward than vector | Brand / product showcase decks |
+| [`minimalist-swiss`](./minimalist-swiss.md) | Swiss-grid Bauhaus austerity, aggressive whitespace | High-end consulting / architecture / luxury / type foundries |
+| [`glassmorphism`](./glassmorphism.md) | Frosted-glass translucent panels, soft shadows | Modern SaaS / fintech / health-tech / premium apps |
| [`3d-isometric`](./3d-isometric.md) | Isometric 3D forms with subtle shadows | Tech architecture / product structure |
| [`digital-dashboard`](./digital-dashboard.md) | Polished UI / data-viz aesthetic | SaaS demos / data products |
| [`corporate-photo`](./corporate-photo.md) | Editorial photography, real subjects | Team / lifestyle / product shots |
@@ -29,6 +31,7 @@ Each rendering has its own file with: style paragraph, container sizing guidance
| [`sketch-notes`](./sketch-notes.md) | Warm cream paper, black hand-drawn lines, pastel fills | Education / training / onboarding |
| [`ink-notes`](./ink-notes.md) | Pure white, black ink, sparse semantic color | Methodology / Before-After / manifestos |
| [`chalkboard`](./chalkboard.md) | Chalk on board, classroom feel | Teaching / tutorials / classroom decks |
+| [`paper-cut`](./paper-cut.md) | Layered paper craft, scissor-cut edges, soft shadows | Education / children / cultural / festival / sustainability |
### 1.3 Narrative / atmospheric
@@ -37,6 +40,7 @@ Each rendering has its own file with: style paragraph, container sizing guidance
| [`watercolor`](./watercolor.md) | Painterly soft edges, color bleeding | Lifestyle / travel / brand story |
| [`warm-scene`](./warm-scene.md) | Golden-hour cinematic warmth | Personal growth / origin story |
| [`screen-print`](./screen-print.md) | Halftone poster art, 2-5 flat colors | Cultural / media / cinematic covers |
+| [`vintage-poster`](./vintage-poster.md) | Mid-century modern poster, halftone + paper grain | Cultural / brand heritage / hospitality / anniversaries |
### 1.4 Specialty
@@ -54,19 +58,23 @@ Match `design_spec.md d. Style` (mode + descriptor) against this table. First ma
| `d. Style` signal | Recommended rendering | Alternates |
|---|---|---|
-| Top Consulting / strategic / MBB | `editorial` or `vector-illustration` | `blueprint` |
+| Top Consulting / strategic / MBB | `editorial` or `vector-illustration` | `blueprint`, `minimalist-swiss` |
| General Consulting / corporate report | `vector-illustration` | `flat`, `digital-dashboard` |
+| High-end consulting / luxury / 高端 / design-firm | `minimalist-swiss` | `editorial`, `vector-illustration` |
| Tech / SaaS / AI / system / architecture | `3d-isometric`, `blueprint`, or `digital-dashboard` | `flat`, `vector-illustration` |
+| Modern SaaS / fintech / health-tech / premium app | `glassmorphism` | `digital-dashboard`, `flat` |
| Product launch / brand / marketing | `flat`, `3d-isometric`, or `corporate-photo` | `vector-illustration` |
-| Education / training / onboarding / 教学 | `sketch-notes` | `vector-illustration` (if school is corporate) |
+| Education / training / onboarding / 教学 | `sketch-notes` | `vector-illustration` (if school is corporate), `paper-cut` |
+| Children / story / storybook / 儿童 | `fantasy-animation` | `paper-cut`, `watercolor`, `sketch-notes` |
+| Cultural / folk / festival / 文化 / 节日 | `paper-cut` | `vintage-poster`, `screen-print` |
| Methodology / Before-After / manifesto / 方法论 | `ink-notes` | `editorial` |
| Government / formal / official report | `editorial` or `corporate-photo` | `vector-illustration` |
| Finance / data journalism / 财经 | `editorial` or `digital-dashboard` | `vector-illustration` |
-| Personal story / 个人成长 / lifestyle | `watercolor`, `warm-scene` | `corporate-photo` |
-| Cultural / media / opinion / cinematic | `screen-print` | `editorial`, `warm-scene` |
-| Children / story / storybook / 儿童 | `fantasy-animation` | `watercolor`, `sketch-notes` |
-| Gaming / retro / 8-bit / 复古 | `pixel-art` | — |
-| Environment / wellness / 环保 / 户外 | `nature` | `watercolor` |
+| Personal story / 个人成长 / lifestyle | `watercolor`, `warm-scene` | `corporate-photo`, `paper-cut` |
+| Cultural / media / opinion / cinematic | `screen-print`, `vintage-poster` | `editorial`, `warm-scene` |
+| Brand heritage / hospitality / 老字号 / 周年 | `vintage-poster` | `screen-print`, `editorial` |
+| Gaming / retro / 8-bit / 复古 | `pixel-art` | `vintage-poster` |
+| Environment / wellness / 环保 / 户外 | `nature` | `watercolor`, `paper-cut` |
| Classroom / blackboard / 课堂 | `chalkboard` | `sketch-notes` |
| Team / company / product photo | `corporate-photo` | — |
diff --git a/skills/ppt-master/references/image-renderings/glassmorphism.md b/skills/ppt-master/references/image-renderings/glassmorphism.md
new file mode 100644
index 00000000..793fbbab
--- /dev/null
+++ b/skills/ppt-master/references/image-renderings/glassmorphism.md
@@ -0,0 +1,74 @@
+# Rendering: glassmorphism
+
+Frosted-glass / soft-UI aesthetic — translucent layered panels, blurred background, soft shadows, depth via transparency. The "modern app UI" rendering — used for modern SaaS, fintech, health-tech, premium app showcases, product launches.
+
+---
+
+## 1. Style paragraph (paste-ready, 105 words)
+
+> Modern glassmorphism aesthetic. Composition built on layered semi-transparent panels with frosted-glass blur — each panel reads as a sheet of polished glass floating slightly above a soft gradient background. Panel edges are subtly defined with thin 1px highlight strokes (whitespace at top/left, slight shadow at bottom/right) suggesting refraction. Background is a soft pastel-cool gradient that blurs through the panels. Drop shadows under panels are large and soft (15-25% opacity, generous spread) to create real depth. Interior content of each panel uses crisp solid color shapes and clean typography character. Overall feel is premium, futuristic-friendly, polished — the aesthetic of contemporary fintech and Apple-style product showcases.
+
+---
+
+## 2. Line, texture, depth
+
+| Aspect | Treatment |
+|---|---|
+| Line quality | Thin 1px highlight strokes on panel top/left edges (glass refraction cue) |
+| Texture | Frosted blur on panels (gaussian blur ~10-15px over background) |
+| Depth | Real layered depth — large soft drop shadows, parallax-suggesting offsets |
+| Material | Translucent polished glass on soft gradient background |
+| Mood | Premium, polished, futuristic-friendly, optimistic |
+
+---
+
+## 3. Container sizing for local PPT inserts
+
+| Embedded position | Recommended canvas | Aspect | Inner padding |
+|---|---|---|---|
+| Full-bleed product hero | 1280×720 | 16:9 | 12% all sides |
+| Half-page UI showcase | 600×500 | ~1.2 | 10-12% |
+| Spot product card | 400×500 | 4:5 | 10% |
+| Hero band | 1200×500 | 2.4:1 | 12% |
+
+---
+
+## 4. Using the deck's HEX values
+
+glassmorphism treats the deck's HEX as **panel content + background gradient stops**:
+
+- Background gradient: a soft transition from a lighter tint of `primary` toward `secondary` (e.g., pale blue → pale gray)
+- Panel fills: semi-transparent (~40-60% opacity) tints of `primary` or near-white
+- Panel content shapes: solid `primary`, with `accent` reserved for the single most-emphasized data point or CTA element
+- Avoid heavy saturation — glassmorphism feels best with mid-light tones; if the deck's primary is very dark, use it only in interior content shapes, not in the gradient
+
+---
+
+## 5. Fewshot prompt snippets
+
+**Snippet A — fintech product showcase, text_policy: none**
+
+> Modern glassmorphism product showcase. Soft pastel-cool background gradient transitioning from light tint of primary `#1E3A5F` (about 30% opacity) in the upper-left to near-white `#F8F9FA` in the lower-right. Two layered frosted-glass panels float above — a larger main panel (about 55% of canvas, centered with slight rotation suggesting 3D depth) and a smaller card peeking from behind the main panel. Each panel has subtle 1px white highlight on its top-left edge and soft 20%-opacity drop shadow beneath (generous spread, suggesting real depth). Interior content: clean solid shapes — a stylized chart bar in primary `#1E3A5F`, a small accent gold `#D4AF37` indicator marking one data point. Crisp, polished, premium. Composed as a 600×500 half-page UI showcase with 12% padding. Color values are rendering guidance only — do not display HEX codes as text. NO text or labels anywhere; SVG will overlay copy.
+
+**Snippet B — full-bleed hero, text_policy: none**
+
+> Modern glassmorphism hero composition. Background is a soft cool gradient (light tint of secondary cream `#FEF3C7` in upper-right, blurred toward pale warm gray in lower-left). One large frosted-glass panel floats at center-right (about 45% of canvas), with a thin 1px highlight on its upper edge and a soft 20%-opacity drop shadow with generous spread. Behind and slightly offset, a second smaller glass panel suggests parallax. Inside the main panel, a single confident accent terracotta `#C2410C` geometric shape (circle or rounded square) acts as the lit focal element. Primary `#9A3412` appears subtly as the interior shape outline. The upper-left third of the canvas is calm gradient — ready for SVG title overlay. Composed as a 1280×720 full-bleed hero with 12% padding. Polished, premium, futuristic-friendly. NO text in the image.
+
+---
+
+## 6. Forbidden
+
+- Hard-edged panels without the highlight/shadow refraction cues (becomes generic flat, loses glass identity)
+- Opaque solid panels (defeats the translucent identity — opacity must be visible)
+- Heavy texture or noise (glass is polished and clean)
+- Skeuomorphic over-shadowing or bevel effects (this is modern glass, not 2010 web design)
+- More than 3-4 layered panels (composition becomes busy)
+
+---
+
+## 7. When to switch away
+
+- For pure data-viz authenticity → `digital-dashboard`
+- For corporate restraint without polish → `vector-illustration` or `flat`
+- For depth via solid 3D forms → `3d-isometric`
+- For premium dark mood → `dark-cinematic` palette + any rendering
diff --git a/skills/ppt-master/references/image-renderings/minimalist-swiss.md b/skills/ppt-master/references/image-renderings/minimalist-swiss.md
new file mode 100644
index 00000000..aefb259a
--- /dev/null
+++ b/skills/ppt-master/references/image-renderings/minimalist-swiss.md
@@ -0,0 +1,74 @@
+# Rendering: minimalist-swiss
+
+Swiss-grid / Bauhaus-adjacent visual discipline. Grid-locked geometry, generous negative space, sans-serif typographic character, no decoration. The most restrained rendering — used for high-end consulting, architecture, design firms, luxury brands, type foundries.
+
+---
+
+## 1. Style paragraph (paste-ready, 100 words)
+
+> Strict Swiss-grid minimalism. Composition is built on a visible or implied modular grid — every element snaps to grid lines, deliberate column-and-row alignment carries the whole page. Forms are reduced to essential geometric primitives — clean rectangles, perfect circles, single-weight lines. Typographic character is sans-serif, often Helvetica-adjacent, set with rigorous spacing. Color is applied sparingly — usually one primary block, large fields of white or near-white, single accent. No gradients, no shadows, no texture, no decoration. Negative space carries as much weight as filled areas. Overall feel is rigorous, considered, almost academic — the aesthetic of Müller-Brockmann posters and Vignelli design systems.
+
+---
+
+## 2. Line, texture, depth
+
+| Aspect | Treatment |
+|---|---|
+| Line quality | Single uniform stroke weight; mathematically straight or perfectly circular |
+| Texture | None — flat fills only |
+| Depth | None — strictly 2D; no shadows, no perspective |
+| Material | None — color is conceptual zone |
+| Mood | Rigorous, considered, austere, academic |
+
+---
+
+## 3. Container sizing for local PPT inserts
+
+| Embedded position | Recommended canvas | Aspect | Inner padding |
+|---|---|---|---|
+| Full-bleed grid page | 1280×720 | 16:9 | 18-20% all sides (Swiss design needs aggressive whitespace) |
+| Half-page composition | 600×600 | 1:1 | 18% |
+| Hero band | 1200×400 | 3:1 | 20% sides |
+| Spot composition | 400×400 | 1:1 | 15% |
+
+---
+
+## 4. Using the deck's HEX values
+
+minimalist-swiss treats colors as **conceptual zones**, not decoration. Apply HEX exactly — one color dominates a deliberate grid cell, secondary fills the field, accent appears at one rule-of-thirds intersection only.
+
+- Primary HEX: one large grid block (typically a square or rectangle covering 20-30% of canvas)
+- Secondary HEX: the field (most of the canvas — usually near-white)
+- Accent HEX: a single thin line or a single small dot — never more than 2-3% of canvas
+- Outlines: rarely used; when needed, the deck's primary in 1px
+
+---
+
+## 5. Fewshot prompt snippets
+
+**Snippet A — half-page composition, text_policy: none**
+
+> Strict Swiss-grid minimalist composition. The canvas is built on an invisible 6-column grid. One large primary deep navy `#1E3A5F` square occupies the lower-left grid cells (about 25% of canvas area), positioned with rigorous alignment to the grid. The rest of the canvas is secondary near-white `#F8F9FA` — calm, vast, deliberate negative space. One thin horizontal accent gold `#D4AF37` line sits at the upper rule-of-thirds, spanning four grid columns (about 2% of canvas area). No other elements. No gradients, no shadows, no texture, no decoration. Composed as a 600×600 half-page block with 18% inner padding. Color values are rendering guidance only — do not display HEX codes or color names as text in the image. NO text of any kind anywhere in the image.
+
+**Snippet B — hero band, text_policy: none**
+
+> Swiss-grid minimalist hero band. Composition divided on a strict modular grid into rectangular zones. Left third: solid primary deep teal `#0F766E` rectangle. Center third: secondary near-white `#F8F9FA` calm field. Right third: secondary near-white `#F8F9FA` field with one small accent burnt-orange `#C2410C` circle positioned at the grid's rule-of-thirds intersection (about 2% of canvas). All edges are mathematically straight, all alignment is grid-precise. No decoration, no gradients, no shadows. Composed as a 1200×400 hero band with 20% side padding. NO text or labels. Color values are rendering guidance only.
+
+---
+
+## 6. Forbidden
+
+- Decorative elements, illustrative iconography, ornamental flourishes (defeats Swiss discipline)
+- Gradients, shadows, glows, textures (minimalist-swiss is strictly flat)
+- Multiple accents in the same composition (one accent only)
+- Off-grid placement, free-form positioning (every element snaps to grid)
+- More than 3 colors total
+
+---
+
+## 7. When to switch away
+
+- For warmer / softer aesthetic → `flat` or `editorial`
+- For tech depth → `3d-isometric` or `blueprint`
+- For data products → `digital-dashboard`
+- For human warmth → `corporate-photo` or `warm-scene`
diff --git a/skills/ppt-master/references/image-renderings/paper-cut.md b/skills/ppt-master/references/image-renderings/paper-cut.md
new file mode 100644
index 00000000..0dd5c362
--- /dev/null
+++ b/skills/ppt-master/references/image-renderings/paper-cut.md
@@ -0,0 +1,74 @@
+# Rendering: paper-cut
+
+Layered paper-craft aesthetic — crisp scissor-cut edges, subtle paper shadows where layers overlap, hand-cut character. Used for education, children's content, cultural/folk topics, sustainability/environment, gift/festival contexts, storytelling decks.
+
+---
+
+## 1. Style paragraph (paste-ready, 100 words)
+
+> Layered paper-cut craft aesthetic. The composition is built as if cut from colored construction paper and stacked in layers — each shape has crisp scissor-cut edges (slightly irregular, hand-aware, not mathematically perfect) and casts a soft 8-12% drop shadow onto the layer beneath, giving real tactile depth. Each color appears as its own paper sheet with subtle paper grain at 10-15% opacity. Forms are simplified and stylized — recognizable as paper craft rather than illustration. Composition reads as cozy, warm, made-by-hand. Overall feel is approachable, tactile, child-friendly without being childish — the aesthetic of Eric Carle storybooks and contemporary folk illustration.
+
+---
+
+## 2. Line, texture, depth
+
+| Aspect | Treatment |
+|---|---|
+| Line quality | No outlines — shapes are defined by paper edges (slightly irregular cuts) |
+| Texture | Paper grain at 10-15% opacity over each color sheet |
+| Depth | Real layered depth via soft 8-12% drop shadow under each cut-paper layer |
+| Material | Construction paper / cardstock — matte, slightly fibrous |
+| Mood | Warm, tactile, approachable, hand-made |
+
+---
+
+## 3. Container sizing for local PPT inserts
+
+| Embedded position | Recommended canvas | Aspect | Inner padding |
+|---|---|---|---|
+| Full-bleed storybook page | 1280×720 | 16:9 | 12% all sides |
+| Half-page paper scene | 600×600 | 1:1 | 12% |
+| Hero teaching banner | 1200×500 | 2.4:1 | 12% |
+| Spot paper-craft icon | 400×400 | 1:1 | 10% |
+
+---
+
+## 4. Using the deck's HEX values
+
+paper-cut treats each HEX value as **one color of paper**:
+
+- Primary HEX: the dominant paper layer (largest or most-foreground sheet)
+- Secondary HEX: background paper (the lowest layer / "table" behind the cut shapes)
+- Accent HEX: a small cut-out shape on the top layer
+- Layering matters more than proportion — even a small primary sheet placed in front of a large secondary feels primary-led
+
+---
+
+## 5. Fewshot prompt snippets
+
+**Snippet A — educational scene, text_policy: none**
+
+> Layered paper-cut craft scene. Background sheet: secondary warm cream `#FEF3C7` paper with subtle grain at 12% opacity (the "table" the composition sits on). On top: a simplified paper-cut tree made of two layered cut shapes — a primary deep green `#0F766E` rounded foliage shape with slightly irregular scissor-cut edge, casting a soft 10% drop shadow onto the cream background; below it, a darker brown trunk cut shape. To the side of the tree: a small accent ochre `#D4A017` cut sun in a corner, with its own soft shadow. No outlines anywhere — shapes are defined by paper edges only. Every layer has paper grain at 12% opacity. Composed as a 600×600 half-page paper scene with 12% padding. NO text in the image. Color values are rendering guidance only.
+
+**Snippet B — hero teaching banner, text_policy: none**
+
+> Layered paper-cut hero banner. Background sheet: secondary pale blue `#DBEAFE` paper with subtle grain. Three simplified paper-cut figures arranged across the canvas — each a stylized silhouette built from 2-3 layered cut shapes (head, body, simple gesture). Two figures are primary deep navy `#1E3A5F` paper, the middle figure is accent terracotta `#9A3412` paper for emphasis. Each layer casts a soft 10% drop shadow onto the layer beneath. No facial features — figures are silhouette-only paper craft. Paper grain at 12% opacity over every layer. Composed as a 1200×500 hero teaching banner with 12% padding. NO text, letters, or numbers anywhere. Color values are rendering guidance only.
+
+---
+
+## 6. Forbidden
+
+- Outlines / line work (defeats the cut-paper identity — shapes are defined by edges, not strokes)
+- Mathematically perfect edges (paper-cut edges must show slight hand-cut irregularity)
+- Photorealistic textures (paper-cut is stylized craft)
+- Gradients within shapes (each shape is one solid paper color)
+- Heavy drop shadows (8-12% opacity max — paper is light, not heavy)
+
+---
+
+## 7. When to switch away
+
+- For warm hand-drawn lines (not cut paper) → `sketch-notes`
+- For watercolor flow → `watercolor`
+- For storybook illustration → `fantasy-animation`
+- For corporate restraint → `vector-illustration` or `flat`
diff --git a/skills/ppt-master/references/image-renderings/vintage-poster.md b/skills/ppt-master/references/image-renderings/vintage-poster.md
new file mode 100644
index 00000000..48956bef
--- /dev/null
+++ b/skills/ppt-master/references/image-renderings/vintage-poster.md
@@ -0,0 +1,74 @@
+# Rendering: vintage-poster
+
+Mid-century modern (1950s–1970s) poster aesthetic. Limited color palette, halftone or paper texture, retro geometric character, hand-drawn warmth without looseness. Used for cultural decks, brand storytelling, hospitality, retro tech narratives, anniversaries, heritage brands.
+
+---
+
+## 1. Style paragraph (paste-ready, 105 words)
+
+> Mid-century modern poster aesthetic — the design language of 1950s–1970s travel posters, jazz album covers, and Saul Bass title cards. Composition uses bold geometric shapes with rounded organic edges, often slightly off-axis for retro tension. Color is applied in limited flat blocks (typically 3-5 colors total) with subtle halftone or screen-print texture over the fills. Lines are thick but hand-aware — not perfectly mechanical, with slight character. Imagery is stylized and reduced — a stylized sun, an angular mountain, an iconic silhouette — never photorealistic. Paper grain at ~10% opacity overlays the composition for tactile age. Overall feel is warm, confident, nostalgic without being kitsch — the aesthetic of Knoll, Olivetti, Pan Am.
+
+---
+
+## 2. Line, texture, depth
+
+| Aspect | Treatment |
+|---|---|
+| Line quality | Confident thick lines with slight hand-aware character; rounded corners |
+| Texture | Halftone dot pattern OR subtle paper grain at 10-15% opacity over fills |
+| Depth | Flat — depth implied via overlapping shapes, never via shadow |
+| Material | Printed-paper aesthetic — slight ink misregistration adds authenticity |
+| Mood | Warm, confident, nostalgic, optimistic-retro |
+
+---
+
+## 3. Container sizing for local PPT inserts
+
+| Embedded position | Recommended canvas | Aspect | Inner padding |
+|---|---|---|---|
+| Full-bleed poster page | 1280×720 | 16:9 | 12% all sides |
+| Half-page poster block | 600×800 | 3:4 | 12% |
+| Hero band | 1200×500 | 2.4:1 | 12% |
+| Square album-cover style | 700×700 | 1:1 | 12% |
+
+---
+
+## 4. Using the deck's HEX values
+
+vintage-poster works best when the deck's HEX values lean **earthy or saturated-warm**. Cool-corporate primaries can work but lose some retro character.
+
+- Primary HEX: dominant shape fills (large geometric blocks)
+- Secondary HEX: paper-field background (often warm cream rather than pure white)
+- Accent HEX: small accent shapes or the halftone overlay tint
+- Add 1-2 additional muted retro neutrals (warm cream, faded ivory) if the deck only specifies a primary triplet
+
+---
+
+## 5. Fewshot prompt snippets
+
+**Snippet A — travel-poster hero, text_policy: none**
+
+> Mid-century modern travel-poster composition. A stylized angular mountain silhouette in primary deep teal `#0F766E` rises across the lower 60% of the canvas, slightly off-axis for retro tension. Above it, a perfect-circle sun in accent burnt-orange `#C2410C` sits at the upper-right rule-of-thirds. Background is warm cream `#FEF3C7` (the deck's secondary, slightly toned toward paper). Subtle halftone dot pattern at 12% opacity overlays the mountain and sun. Thin slightly-misregistered ink offset along the mountain edge adds screen-print authenticity. Paper grain at 10% opacity over the whole composition. No additional elements. Composed as a 1200×500 hero poster band with 12% padding. NO text, letters, or numbers in the image. Color values are rendering guidance only.
+
+**Snippet B — album-cover style spot, text_policy: none**
+
+> Mid-century modern album-cover composition. A stylized abstract figure formed from interlocking geometric shapes — a half-circle, a triangle, a thick curved line — arranged in deliberate retro asymmetry. Primary mustard `#D4A017` and secondary deep maroon `#7C2D12` carry the figure. A small accent cream `#FEF3C7` shape acts as the visual rest. Background is muted warm gray with subtle paper grain at 12% opacity. Halftone overlay at 10% opacity over the figure. Slight ink misregistration along edges suggests screen-print. Composed as a 700×700 square poster spot with 12% padding. NO text in the image. Color values are rendering guidance only.
+
+---
+
+## 6. Forbidden
+
+- Photorealistic imagery (defeats poster stylization)
+- Modern thin-line vector look (this is hand-aware retro)
+- More than 5 colors total
+- Gradients (vintage-poster uses flat color + halftone, never smooth gradient)
+- Clean digital edges without any misregistration or paper texture
+
+---
+
+## 7. When to switch away
+
+- For pure poster without retro reference → `screen-print`
+- For corporate restraint → `vector-illustration` or `flat`
+- For story / narrative atmosphere → `warm-scene` or `watercolor`
+- For magazine editorial → `editorial`
diff --git a/skills/ppt-master/references/image-type-templates/_index.md b/skills/ppt-master/references/image-type-templates/_index.md
index 05f0d8fc..b7e4d160 100644
--- a/skills/ppt-master/references/image-type-templates/_index.md
+++ b/skills/ppt-master/references/image-type-templates/_index.md
@@ -8,7 +8,7 @@ A **type** describes what the image's **internal composition** looks like — it
---
-## 1. Catalog (9 types)
+## 1. Catalog (15 types)
Each type has its own file with: composition skeleton (LAYOUT / ELEMENTS / NEGATIVE SPACE), container sizing options, text-policy variants, fewshot snippets.
@@ -16,12 +16,18 @@ Each type has its own file with: composition skeleton (LAYOUT / ELEMENTS / NEGAT
|---|---|---|
| [`background`](./background.md) | Atmospheric backdrop, no central subject | Cover bg, chapter divider bg, hero overlay bg |
| [`hero`](./hero.md) | Single dominant subject (60-70% of canvas) | Product/concept reveal, chapter title bg |
+| [`portrait`](./portrait.md) | One person headshot / upper body, neutral background | Team page / speaker bio / testimonial / founder profile |
| [`typography`](./typography.md) | Large headline / number / single word as visual | Big-stat pages, slogan pages, chapter openers |
| [`infographic`](./infographic.md) | 2-5 ordered zones with icons + minimal labels | Data summary / step list / KPI rundown |
| [`flowchart`](./flowchart.md) | Sequential blocks connected by arrows | Process / workflow / pipeline |
-| [`framework`](./framework.md) | Central node + radiating satellites (or matrix) | Methodology / model / system architecture |
+| [`framework`](./framework.md) | Central node + radiating satellites | Methodology / model / system architecture |
+| [`matrix`](./matrix.md) | 2×2 quadrant grid with two perpendicular axes | SWOT / BCG / Eisenhower / Ansoff / Porter |
+| [`cycle`](./cycle.md) | Closed loop, 3-6 steps with arrows returning | PDCA / flywheel / design thinking / continuous improvement |
+| [`funnel`](./funnel.md) | Top-wide bottom-narrow conversion stack | Marketing funnel / sales pipeline / hiring funnel |
+| [`pyramid`](./pyramid.md) | Bottom-wide top-narrow hierarchical tiers | Maslow / capability stack / value hierarchy |
| [`comparison`](./comparison.md) | Split composition (left vs right, before vs after) | A/B / pros-cons / Before-After |
| [`timeline`](./timeline.md) | Linear progression along an axis | History / roadmap / evolution |
+| [`map`](./map.md) | Stylized geographic outline with annotated markers | Offices / market presence / regional data / supply chain |
| [`scene`](./scene.md) | Atmospheric environment with narrative | Story / lifestyle / case study |
---
@@ -34,12 +40,18 @@ For each row in `design_spec.md §VIII Image Resource List`, match `Purpose` aga
|---|---|---|
| Cover background / chapter background / divider bg | `background` | `none` |
| Product reveal / hero / headline visual | `hero` | `none` (or `embedded` for headline-as-image) |
+| Team headshot / speaker bio / founder profile / testimonial | `portrait` | `none` |
| Big number / KPI single visual / quote | `typography` | `embedded` |
| Data summary / metrics rundown / step list | `infographic` | `none` (labels in SVG) or `embedded` (keywords in image) |
| Process / workflow / pipeline / steps with arrows | `flowchart` | `none` |
| Methodology / model / framework / architecture diagram | `framework` | `none` |
+| 2×2 quadrant / SWOT / BCG / Eisenhower / Ansoff | `matrix` | `none` |
+| Closed-loop process / PDCA / flywheel / continuous improvement | `cycle` | `none` |
+| Conversion funnel / sales pipeline / hiring funnel | `funnel` | `none` |
+| Hierarchy / Maslow / value stack / capability layer | `pyramid` | `none` |
| Comparison / Before-After / A/B / VS | `comparison` | `none` |
| History / evolution / roadmap / timeline | `timeline` | `none` |
+| Offices / market presence / regions / supply chain / geography | `map` | `none` |
| Team / lifestyle / story / scenario / case | `scene` | `none` |
> When `Purpose` mentions text-rich keywords ("with caption", "labeled", "annotated"), bias toward `embedded` text-policy. When unsure, default to `none` — SVG text overlay is more flexible than image-embedded text.
@@ -54,12 +66,18 @@ The Resource List's `Dimensions` column is authoritative. If absent, use these d
|---|---|---|
| background | 1280×720 full-bleed (still mark `page_role: local` — SVG text overlays on top) | 16:9 |
| hero | 800×600 or 1280×720 | 4:3 / 16:9 |
+| portrait | 400×500 or 600×800 | 4:5 / 3:4 |
| typography | 800×500 | 16:10 |
| infographic | 600×500 or 700×700 | ~1.2 / 1 |
| flowchart | 1200×400 (horizontal banner) | 3:1 |
| framework | 700×700 square | 1:1 |
+| matrix | 800×800 or 1280×720 | 1:1 / 16:9 |
+| cycle | 700×700 or 800×800 square | 1:1 |
+| funnel | 600×800 portrait | 3:4 |
+| pyramid | 600×800 portrait | 3:4 |
| comparison | 1200×500 split / 600×500 each | 2.4 / 1.2 |
| timeline | 1200×350 banner | 3.4:1 |
+| map | 1280×720 or 1200×500 | 16:9 / 2.4:1 |
| scene | 1200×720 wide / 800×600 | 16:10 / 4:3 |
> All sizes include the 12-20% inner padding requirement. The model paints content within the inner safe zone; outer edges should feel airy.
diff --git a/skills/ppt-master/references/image-type-templates/cycle.md b/skills/ppt-master/references/image-type-templates/cycle.md
new file mode 100644
index 00000000..5c2326f1
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/cycle.md
@@ -0,0 +1,89 @@
+# Type: cycle
+
+A **closed-loop process** — 3-6 steps arranged in a circle (or rounded loop), connected by directional arrows that return the flow to its starting point. The structural backbone for PDCA, growth flywheel, design-thinking cycle, continuous-improvement loops, lifecycle diagrams.
+
+> **What cycle means inside a PPT block**: a **closed circular flow** — every step leads to the next, and the last step leads back to the first. Unlike `flowchart` (linear, one-way), cycle has no terminal end. Unlike `framework` (centered hub with passive satellites), cycle has directional motion around the perimeter.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌─────────┐
+ ┌────▶│ Step 1 │────┐
+ │ └─────────┘ │
+ │ ▼
+ ┌───┴───┐ ┌─────────┐
+ │ Step 4│ │ Step 2 │
+ └───────┘ └────┬────┘
+ ▲ │
+ │ ┌─────────┐ │
+ └─────│ Step 3 │◀─────┘
+ └─────────┘
+```
+
+| LAYOUT | 3-6 step nodes arranged on a circular (or rounded square) perimeter; arrows connect each node to the next, closing back to the first |
+| ELEMENTS | One simple iconic symbol per step + curved or straight directional arrows between them. Optional central anchor (a label, a small icon representing the cycle's name) |
+| NEGATIVE SPACE | Center of the circle is calm — either empty or holds a small anchor element only |
+| BALANCE | Step nodes spaced evenly around the perimeter; arrow weights uniform |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Full-bleed cycle diagram | 1280×720 | 16:9 | 15% (cycle reads best with breathing room) |
+| Half-page cycle block | 700×700 | 1:1 | 15% |
+| Square cycle reference | 800×800 | 1:1 | 12% |
+| Hero cycle band | 1200×600 | 2:1 | 15% |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+Step labels are added later as SVG overlay. Each step shows an icon only; the SVG positions the label adjacent to its step. This is the recommended path.
+
+Sample fragment:
+
+> NO text, letters, numbers, or step labels in the image. Each step node contains only one simple iconic symbol; SVG text overlay will add step names externally.
+
+### 3.2 `text_policy: embedded` (occasional)
+
+Use when the user wants a fully self-contained cycle diagram. Keep step names to single English words ("PLAN", "DO", "CHECK", "ACT").
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — vector-illustration + cool-corporate PDCA cycle, text_policy: none, 700×700**
+
+> Clean flat vector illustration of a closed-loop process cycle. Four step nodes arranged in a perfect circle on the canvas perimeter — at 12 o'clock, 3 o'clock, 6 o'clock, and 9 o'clock positions. Each node is a rounded square (about 130×130px equivalent) filled with primary deep navy `#1E3A5F`, with one simple white iconic symbol centered inside — a clipboard (plan), a hand (do), a magnifying glass (check), a gear (act). Curved directional arrows in accent gold `#D4AF37` connect each node to the next going clockwise, closing the loop. The center of the circle is calm — secondary light gray `#F8F9FA` field with one small accent gold dot at the exact center as the cycle's anchor. Crisp 2px outlines, soft 8% drop shadow under each node. Composed as a 700×700 half-page cycle block with 15% padding. NO text, letters, or step labels anywhere — SVG will overlay all step names. Color values are rendering guidance only.
+
+**Snippet B — flat + tech-neon growth flywheel, text_policy: none, 800×800**
+
+> Modern flat geometric flywheel composition. Six step nodes arranged evenly around a circular perimeter, each rotated slightly toward the cycle's rotation direction to suggest motion. Each node is a hexagonal shape filled with primary electric blue `#0EA5E9`, containing one simple white iconic symbol — a user, a heart, a star, a megaphone, an upward arrow, a refresh icon. Between each pair of nodes, a curved arrow in accent vivid cyan `#06B6D4` flows clockwise, the arrows getting slightly thicker as they progress (suggesting acceleration). The center holds a small flat circle in accent cyan with a single white spark icon — the flywheel's anchor. Background secondary deep navy `#0A0E27`. Composed as an 800×800 cycle block with 12% padding. NO text or labels anywhere. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Cycle reads as flowchart (linear, with end) | "Closed loop" rule weak | Strengthen with "last step's arrow returns to the first step, closing the loop — no terminal endpoint" |
+| Nodes unevenly spaced | Position rule omitted | "N nodes spaced at perfectly equal intervals around the perimeter (clock positions: 12, 4, 8 for 3 nodes; 12, 3, 6, 9 for 4; etc.)" |
+| Center too busy | Anchor element overgrown | "Center holds at most one small anchor element occupying under 10% of canvas area" |
+| Arrows ambiguous direction | Direction not stated | "Curved directional arrows clearly point clockwise (or counterclockwise — specify one), arrowhead visible at each arrival point" |
+| Too many or too few steps | Step count drifted | Explicitly state "exactly N step nodes" |
+
+---
+
+## 6. When to switch away from cycle
+
+- If process is **linear with a defined end** → `flowchart`
+- If structure is **central hub with passive satellites** (no motion around perimeter) → `framework`
+- If two states compared (before/after) → `comparison`
+- If chronological progression along an axis → `timeline`
+- If tiered / layered → `pyramid`
diff --git a/skills/ppt-master/references/image-type-templates/funnel.md b/skills/ppt-master/references/image-type-templates/funnel.md
new file mode 100644
index 00000000..826330fc
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/funnel.md
@@ -0,0 +1,90 @@
+# Type: funnel
+
+A **top-wide, bottom-narrow stack** of horizontal bands representing successive conversion stages. Each band is narrower than the one above it, suggesting attrition/filtering as the process progresses. The standard structural backbone for marketing funnels, sales pipelines, hiring funnels, customer-journey conversion.
+
+> **What funnel means inside a PPT block**: a **converging-downward** stack — visual weight shrinks as you descend, embodying "many enter the top, few reach the bottom". Unlike `pyramid` (which can be either direction but typically narrows-upward for hierarchy/value), funnel is **always wide-to-narrow downward** and is about **filtering**, not hierarchy.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌──────────────────────────────────┐ ← Band 1 (widest)
+ │ Awareness │
+ ├──────────────────────────────── ┤
+ ┌────────────────────────────┐ ← Band 2 (narrower)
+ │ Interest │
+ ├────────────────────────── ┤
+ ┌──────────────────────┐ ← Band 3
+ │ Consideration │
+ ├──────────────────── ┤
+ ┌──────────────┐ ← Band 4
+ │ Conversion │
+ └──────────────┘
+```
+
+| LAYOUT | 3-6 horizontal bands stacked vertically; each band's width decreases by ~15-25% from the band above |
+| ELEMENTS | One simple iconic symbol per band (left side) + the band itself as the dominant color block. Optional thin divider lines between bands |
+| NEGATIVE SPACE | Side margins grow as bands narrow — outer field on either side of the lower bands provides breathing room |
+| BALANCE | Vertical center axis is the funnel's spine — all bands center-align to this axis |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Full-bleed funnel page | 1280×720 | 16:9 | 12% sides, 10% top/bottom |
+| Portrait funnel block | 600×800 | 3:4 | 12% (portrait reads funnels naturally) |
+| Half-page funnel | 600×700 | ~0.85 | 12% |
+| Square reference funnel | 700×700 | 1:1 | 12% |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+Stage labels are added later as SVG overlay. Each band shows an icon only; the SVG places stage names beside or inside each band. Recommended path.
+
+Sample fragment:
+
+> NO text, letters, numbers, or stage labels in the image. Each band contains only one simple iconic symbol; SVG text overlay will add stage names externally.
+
+### 3.2 `text_policy: embedded` (occasional)
+
+Use when the user wants a fully self-contained funnel diagram. Keep band names to single English words ("AWARE", "LIKE", "BUY", "REFER"). High failure risk on 5+ band funnels.
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — vector-illustration + cool-corporate marketing funnel, text_policy: none, 600×800**
+
+> Clean flat vector illustration of a marketing conversion funnel. Four horizontal bands stacked vertically, each band centered on the vertical axis and each ~20% narrower than the one above. Band 1 (top, widest): primary deep navy `#1E3A5F` solid fill, with a simple white megaphone icon centered on the left. Band 2: secondary lighter navy tint, with a heart icon. Band 3: accent gold `#D4AF37`, with a shopping-cart icon. Band 4 (bottom, narrowest): deeper accent gold, with a star icon. Each band has crisp straight edges and 8% drop shadow beneath. Thin secondary cream `#F8F9FA` dividers separate the bands. Background is calm secondary cream. Composed as a 600×800 portrait funnel block with 12% padding. NO text, letters, numbers, or stage labels anywhere — SVG will overlay all band names. Color values are rendering guidance only.
+
+**Snippet B — flat + vivid-launch sales pipeline, text_policy: none, 600×700**
+
+> Flat geometric sales pipeline funnel. Five horizontal bands stacked vertically with a smooth gradient of narrowing widths (each band ~18% narrower than the one above). Bands cycle through the deck's three colors as flat solid fills: band 1 in primary vivid coral `#F97316`, band 2 in secondary cream `#FEF3C7`, band 3 in primary coral, band 4 in accent deep purple `#7C3AED`, band 5 (narrowest) in deeper purple. Each band has one simple white iconic symbol centered on its left third — a magnet, an eye, a hand, a handshake, a trophy. Crisp solid edges, no gradients, no shadows beyond a single 8% drop. The funnel's narrowing creates symmetric breathing room on left and right. Composed as a 600×700 half-page funnel block with 12% padding. NO text or labels in the image. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Bands not narrowing (looks like stacked bars) | Width gradient omitted | "Each successive band is 15-25% narrower than the band above it — the funnel must visibly converge" |
+| Bands off-center | Center-axis rule omitted | "All bands center-align on the canvas vertical axis — the funnel is symmetrical left-right" |
+| Pyramid shape (narrowing upward) | Direction reversed | "Funnel narrows DOWNWARD — widest band at the top, narrowest at the bottom" |
+| Wrong number of bands | Count drifted | Explicitly state "exactly N bands" |
+| Bands visually equivalent in importance | Color cycling weak | "Color progression supports the conversion narrative — typically primary at top fades through palette to accent at bottom (or vice versa)" |
+
+---
+
+## 6. When to switch away from funnel
+
+- If structure is **value/hierarchy stack (narrowing upward)** → `pyramid`
+- If structure is **linear sequential with no narrowing** → `flowchart` or `timeline`
+- If closed loop with feedback → `cycle`
+- If two-way comparison → `comparison`
+- If central hub + radial → `framework`
diff --git a/skills/ppt-master/references/image-type-templates/map.md b/skills/ppt-master/references/image-type-templates/map.md
new file mode 100644
index 00000000..cffa4ae7
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/map.md
@@ -0,0 +1,91 @@
+# Type: map
+
+A **stylized geographic outline** (country / region / continent / world) with annotated markers — pins, dots, highlighted regions, connection lines. Used for office locations, market presence, regional data distribution, supply-chain routes, expansion roadmaps, go-to-market geographies.
+
+> **What map means inside a PPT block**: a **schematic geographic visualization**, not a photorealistic globe view. Stylized landmasses with simplified outlines, deliberate marker placement, and minimal cartographic detail. Unlike `infographic` (abstract data zones), map has **real geographic shape** anchoring the composition.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌────────────────────────────────────┐
+ │ ▓▓▓▓▓ │
+ │ ▓▓▓ ▓▓▓ ● │
+ │ ▓▓ ▓▓▓ │
+ │ ▓ Stylized ▓▓ ● │
+ │ ▓▓ landmass ▓▓ │
+ │ ▓▓▓ ▓▓ │
+ │ ▓▓▓ ●▓▓ │
+ │ ▓▓▓▓▓ │
+ │ │
+ │ ● = location markers │
+ └────────────────────────────────────┘
+```
+
+| LAYOUT | One or more simplified landmass outlines positioned on the canvas; marker dots/pins placed at meaningful geographic positions; optional thin connector lines between markers |
+| ELEMENTS | The landmass (flat fill or stylized outline) + 3-12 markers + optional region highlights (one or two regions with deeper color) + optional connection arcs |
+| NEGATIVE SPACE | Ocean / negative space around the landmass — at least 25% of canvas. Markers should not crowd the landmass edges. |
+| BALANCE | Geographic accuracy is approximate but recognizable — viewer should identify the region within one glance |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Full-bleed map page | 1280×720 | 16:9 | 12% all sides (world map fits 16:9 well) |
+| Half-page country map | 600×600 | 1:1 | 12% |
+| Wide regional map | 1200×500 | 2.4:1 | 12% |
+| Square continent map | 700×700 | 1:1 | 12% |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+City / country / region names are added later as SVG overlay. The map shows markers only; SVG text labels each marker position.
+
+Sample fragment:
+
+> NO text, letters, numbers, country names, city names, or marker labels in the image. Markers are dots/pins only; SVG text overlay will add all labels externally.
+
+### 3.2 `text_policy: embedded` (rare)
+
+Use only when the user wants a fully self-contained reference map. High failure risk — image models often misspell place names or place them on wrong coordinates. Recommend `none` and SVG overlay instead.
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — vector-illustration + cool-corporate world office map, text_policy: none, 1280×720**
+
+> Clean flat vector illustration of a stylized world map. Simplified continental landmasses (recognizable but not photorealistic) in primary deep navy `#1E3A5F` solid fill, positioned across the canvas with approximate geographic accuracy. Ocean/negative space is secondary light gray `#F8F9FA`. Eight small accent gold `#D4AF37` circular markers placed at meaningful office locations — three in North America, two in Europe, one in East Asia, one in South Asia, one in Australia. Each marker has a thin pulsing-glow effect at 30% opacity (a subtle ring around the dot). Two thin accent gold connection lines (slightly curved, suggesting flight paths) connect three of the markers. Crisp 1.5px outlines on the landmasses. No country borders within continents — landmasses are single-color solid silhouettes. Composed as a 1280×720 full-bleed world map with 12% padding. NO text, country names, or labels anywhere — SVG will overlay all labels. Color values are rendering guidance only.
+
+**Snippet B — flat + tech-neon Asia-Pacific market map, text_policy: none, 1200×500**
+
+> Modern flat geometric stylized map of the Asia-Pacific region. Recognizable simplified outlines of China, Japan, Korea, Southeast Asian countries, and Australia in primary electric blue `#0EA5E9` solid fill. Ocean is secondary deep navy `#0A0E27`. Six accent vivid cyan `#06B6D4` circular markers placed at major commercial cities. Two markers (the highest-value ones) carry a subtle outer glow halo at 25% opacity. Curved thin accent cyan arcs (3-4 of them) suggest trade routes between markers. No country borders, no political subdivisions — landmasses are single-color silhouettes. Composed as a 1200×500 wide regional map block with 12% padding. NO text, country names, or labels in the image. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Landmasses unrecognizable | Stylization went too far | "Landmasses simplified but recognizable — viewer must identify the region at a glance" |
+| Photorealistic globe / satellite imagery | Wrong cartographic register | Reaffirm "stylized flat vector silhouette, NOT photorealistic globe view" |
+| Country borders cluttering | Sub-region detail crept in | "Landmasses are single-color silhouettes — NO country borders within continents, no political subdivisions" |
+| Markers off-coast / on ocean | Geographic placement loose | "Markers placed on land at approximately accurate geographic positions" |
+| Misspelled place names | Text policy violated | Set `text_policy: none` and add labels in SVG |
+| Map fills entire canvas (no breathing) | Negative space rule omitted | "Ocean / negative space surrounds the landmass on all sides — at least 25% of canvas is open ocean" |
+
+---
+
+## 6. When to switch away from map
+
+- If geographic shape is irrelevant (just abstract data zones) → `infographic`
+- If data is sequential / chronological → `timeline`
+- If structure is hierarchical → `pyramid` or `framework`
+- If comparing two regions explicitly → `comparison` (each side a map)
+- If atmospheric environment / scene → `scene`
diff --git a/skills/ppt-master/references/image-type-templates/matrix.md b/skills/ppt-master/references/image-type-templates/matrix.md
new file mode 100644
index 00000000..bd18828a
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/matrix.md
@@ -0,0 +1,91 @@
+# Type: matrix
+
+A **2×2 quadrant grid** (occasionally 3×3) where each cell carries its own label, color, or icon. The structural backbone of consulting frameworks — SWOT, BCG, Eisenhower, Ansoff, Porter's, Risk/Reward. Used wherever two orthogonal axes divide the page into discrete zones.
+
+> **What matrix means inside a PPT block**: the canvas is **rigorously divided into equal quadrants** by perpendicular axes. Unlike `framework` (central hub + radiating satellites), matrix has no center — meaning lives in the four cells. Unlike `comparison` (two side-by-side zones), matrix splits **both** horizontally and vertically.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌────────────────┬────────────────┐
+ │ │ │
+ │ Quadrant 1 │ Quadrant 2 │
+ │ (icon + ) │ (icon + ) │
+ │ │ │
+ ├────────────────┼────────────────┤
+ │ │ │
+ │ Quadrant 3 │ Quadrant 4 │
+ │ (icon + ) │ (icon + ) │
+ │ │ │
+ └────────────────┴────────────────┘
+ ↑ ↑
+ Two perpendicular axes split the canvas
+```
+
+| LAYOUT | Two perpendicular axes (one horizontal, one vertical) cross at canvas center, dividing into 4 equal quadrants |
+| ELEMENTS | One simple iconic symbol per quadrant + optional axis-end indicators (arrows or labels). Each quadrant uses a distinct color or tint from the deck palette |
+| NEGATIVE SPACE | Generous inside each quadrant — the icon should occupy 40-60% of its quadrant's area |
+| BALANCE | Visual weight equal across all four quadrants — no single quadrant dominates |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Full-bleed strategy matrix | 1280×720 | 16:9 | 12% all sides |
+| Half-page quadrant block | 700×700 | 1:1 | 12% |
+| Square reference matrix | 800×800 | 1:1 | 10% |
+| Wide consulting matrix | 1200×600 | 2:1 | 12% sides, 8% top/bottom |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+Quadrants carry icons only; axis labels and quadrant names are added later as SVG overlay. This is the safer choice — image models often render axis-label text inconsistently across the four positions.
+
+Sample fragment:
+
+> NO text, letters, numbers, axis labels, or quadrant names in the image. Each quadrant contains a simple iconic symbol only; SVG text overlay will add axis labels and quadrant names externally.
+
+### 3.2 `text_policy: embedded` (rare)
+
+Use only when the user explicitly wants the axis labels baked into the image. Keep labels to single English words ("HIGH", "LOW", "GROW", "HOLD") and accept higher risk of typo/glyph errors.
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — vector-illustration + cool-corporate SWOT matrix, text_policy: none, 800×800**
+
+> Clean flat vector illustration of a 2×2 strategic matrix. Two perpendicular thin lines in primary deep navy `#1E3A5F` cross at the exact canvas center, dividing the canvas into four equal quadrants. Each quadrant has a subtle background tint: upper-left in pale primary navy at 10% opacity, upper-right in pale accent gold `#D4AF37` at 15% opacity, lower-left in pale gray `#F8F9FA`, lower-right in slightly deeper pale navy at 18% opacity. Each quadrant contains one simple iconic symbol in primary navy, centered within its quadrant — a shield (strength), a lightning bolt (opportunity), a target (weakness), an alert triangle (threat). Each icon occupies about 45% of its quadrant. Small accent gold dots sit at the four outer corners. Composed as an 800×800 reference matrix block with 10% padding. NO text, letters, axis labels, or quadrant names anywhere — SVG will overlay all labels. Color values are rendering guidance only.
+
+**Snippet B — flat + vivid-launch BCG matrix, text_policy: none, 1200×600**
+
+> Clean flat vector matrix composition. Two thick perpendicular lines in primary deep purple `#7C3AED` divide the canvas into four equal quadrants. Each quadrant is filled with a distinct vivid flat color from the deck palette — upper-left deep purple `#7C3AED` solid, upper-right vivid orange `#F97316` solid, lower-left soft secondary cream `#FEF3C7`, lower-right vivid pink `#EC4899` solid. Inside each quadrant, one simple white iconic symbol (centered, about 50% of quadrant area) — a star, a question mark, a cow silhouette, a dog silhouette. Crisp solid fills, no gradients. Small directional arrows mark the two outer axis ends (one pointing up, one pointing right). Composed as a 1200×600 wide consulting matrix with 12% side padding. NO text or labels — SVG overlays axis names and category labels. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Quadrants unequal in size | Center-crossing rule omitted | "Axes cross at EXACT canvas center, four quadrants of equal size" |
+| Icons too small or off-center | Icon sizing rule omitted | Reaffirm "each icon occupies 40-50% of its quadrant, centered within the quadrant" |
+| Text rendered into the image despite `none` | Rule too weak | Strengthen with full exclusion list including "no axis labels, no quadrant names, no titles" |
+| Quadrants visually compete (no clear axis structure) | Axis lines too thin or omitted | "Two perpendicular lines clearly visible — they ARE the matrix structure" |
+| 3×3 grid instead of 2×2 | Model defaulted to standard grid | Explicitly state "exactly 2×2, four quadrants only" |
+
+---
+
+## 6. When to switch away from matrix
+
+- If structure is **central hub + radiating** → `framework`
+- If structure is **left vs right only** (one axis) → `comparison`
+- If structure is **sequential / linear** → `flowchart` or `timeline`
+- If structure is **closed loop** → `cycle`
+- If structure is **tiered / layered** → `pyramid`
diff --git a/skills/ppt-master/references/image-type-templates/portrait.md b/skills/ppt-master/references/image-type-templates/portrait.md
new file mode 100644
index 00000000..c8310ad5
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/portrait.md
@@ -0,0 +1,91 @@
+# Type: portrait
+
+A **single person headshot or upper-body shot** — frontal or three-quarter turn, neutral or minimal background, the face as the visual anchor. Used for team pages, speaker bios, founder profiles, testimonial pages, "about us" sections, executive introductions.
+
+> **What portrait means inside a PPT block**: **one person, face-forward, isolated from environment**. Unlike `scene` (atmospheric environment with narrative), portrait strips away context to focus on the person. Unlike `hero` (any singular subject — product / object / person), portrait is specifically **human face / upper body**.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌────────────────────────────────────┐
+ │ │
+ │ ┌─────────┐ │
+ │ │ Head │ │
+ │ │ / Face │ │
+ │ ├─────────┤ │
+ │ │ Shoulders│ │
+ │ │ / Torso │ │
+ │ └─────────┘ │
+ │ │
+ │ Subject occupies 50-65% of │
+ │ canvas height, centered │
+ └────────────────────────────────────┘
+```
+
+| LAYOUT | Single person centered (or rule-of-thirds offset); head occupies upper third, torso/shoulders the middle. Background is neutral, minimal, or softly blurred. |
+| ELEMENTS | The person (face + upper body) + minimal background context (a soft color field, a gentle gradient, an out-of-focus environment cue). No competing foreground objects. |
+| NEGATIVE SPACE | Generous around the head — at least 15% padding above the crown of the head |
+| BALANCE | The face is the visual anchor; eyes positioned at approximately the upper-third horizontal line (classical portrait rule) |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Team-page headshot | 400×500 | 4:5 | 10% (portrait crops tight to subject) |
+| Square avatar | 600×600 | 1:1 | 10% |
+| Half-page founder bio | 600×800 | 3:4 | 10% |
+| Hero speaker introduction | 1200×720 | ~5:3 | 12% (more breathing on hero) |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+Names, titles, and quotes are added later as SVG overlay. The portrait shows the person only.
+
+Sample fragment:
+
+> NO text, letters, numbers, name tags, or captions in the image. The portrait is the person only; SVG text overlay will add name, title, and any quote externally.
+
+### 3.2 `text_policy: embedded` is essentially never used for this type — switch to `hero` or `typography` if text is required as part of the image.
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — corporate-photo + cool-corporate executive headshot, text_policy: none, 600×800**
+
+> Editorial corporate portrait photograph of one professional executive. The person is centered slightly left of canvas center, photographed from chest-up at eye level, looking confidently toward the camera with a relaxed natural expression — not posed-stiff, not over-smiling. Professionally attired in a contemporary business setting (a tailored blazer, neutral palette clothing). Soft natural light from the upper left, gentle shadow on the right side of the face. Diverse, professionally attired subject, photorealistically rendered, contemporary styling. Background is a softly out-of-focus office context — secondary light gray `#F8F9FA` wall with a subtle hint of primary deep navy `#1E3A5F` in a blurred architectural element. Color grading is cool-corporate — restrained, professional. Shallow depth of field — subject sharp, background gently blurred. Subject's eyes positioned at the upper-third horizontal line. Composed as a 600×800 half-page bio portrait with 10% padding. NO text, name tags, or captions in the image. Color values are rendering guidance only.
+
+**Snippet B — corporate-photo + warm-earth founder portrait, text_policy: none, 400×500**
+
+> Editorial corporate portrait of one entrepreneurial founder. Photographed from head-and-shoulders at eye level in a workspace context. Subject is centered, looking thoughtfully off-camera at a slight three-quarter turn — natural, contemplative expression suggesting reflection. Diverse, contemporary styling — casual but considered (a knit sweater, simple jewelry). Warm window light from the upper right creates golden-amber highlights on the cheek and shoulder. Color grading is warm-earth — image graded toward warm amber `#9A3412` shadows and cream `#FEF3C7` highlights, with a small detail of accent gold `#D4AF37` in the background (a hint of warm wood). Background is gently blurred contextual workspace. Shallow depth of field. Composed as a 400×500 team-page headshot with 10% padding. Diverse, professionally attired subject rendered photorealistically — no posed stock-photo stiffness. NO text or captions. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Multiple people in frame | "Single person" rule weak | Strengthen with "exactly ONE person, no other people visible in the frame" |
+| Background competing with subject | Background rule omitted | "Background softly blurred or neutral solid field — no competing foreground elements" |
+| Stock-photo stiffness | Naturalness rule omitted | Reaffirm "natural relaxed expression — not posed-stiff, not over-smiling, not stock-photo artificial" |
+| Subject cropped at face / head touching edge | Padding rule omitted | "At least 15% padding above the crown of the head — head must not touch upper edge" |
+| Subject's eyes too low in frame | Eye-position rule omitted | "Eyes positioned at approximately the upper-third horizontal line" |
+| Specific celebrity / public-figure likeness | §5.4 omitted | Strengthen with "no celebrity or public-figure likeness — generic professional subject" |
+| Homogeneous casting | Diversity rule omitted | Reaffirm "diverse, contemporary styling — vary age, ethnicity, gender across multiple portraits in the same deck" |
+
+---
+
+## 6. When to switch away from portrait
+
+- If multiple people in environment → `scene`
+- If non-human subject is the focal element → `hero`
+- If subject is a product (no person) → `hero` or `infographic`
+- If full-body lifestyle / case-study narrative → `scene`
+- If the image is just an avatar icon (stylized, not photographic) → consider `typography` (initial-letter avatar) or a vector-illustration hero
diff --git a/skills/ppt-master/references/image-type-templates/pyramid.md b/skills/ppt-master/references/image-type-templates/pyramid.md
new file mode 100644
index 00000000..60d40846
--- /dev/null
+++ b/skills/ppt-master/references/image-type-templates/pyramid.md
@@ -0,0 +1,90 @@
+# Type: pyramid
+
+A **tiered triangular stack** — bottom-wide, top-narrow — where each layer carries its own label/color/concept. The structural backbone for Maslow's hierarchy, food pyramids, capability stacks, value hierarchies, software-architecture layer diagrams.
+
+> **What pyramid means inside a PPT block**: a **converging-upward** layered structure embodying "foundation supports value" — wide stable base, narrow apex of meaning. Unlike `funnel` (narrows downward, about filtering), pyramid narrows upward, about **stacking value or hierarchy**. Unlike `framework` (centered hub), pyramid is **strictly vertical layered**.
+
+---
+
+## 1. Composition skeleton
+
+```
+ ┌──────┐ ← Apex (smallest)
+ │ T 5 │
+ ┌─┴──────┴─┐
+ │ T 4 │
+ ┌─┴──────────┴─┐
+ │ T 3 │
+ ┌─┴──────────────┴─┐
+ │ T 2 │
+ ┌─┴──────────────────┴─┐
+ │ T 1 │ ← Foundation (widest)
+ └──────────────────────┘
+```
+
+| LAYOUT | 3-6 horizontal layers stacked vertically; each layer narrower than the one below it. May be a true triangular outline (sloping sides) OR stepped (right-angled tiers). |
+| ELEMENTS | One simple iconic symbol per tier + the tier itself as the dominant color block. Tier colors usually progress from a darker/heavier color at the base to a brighter/lighter color at the apex (or vice versa, depending on the metaphor) |
+| NEGATIVE SPACE | Side margins grow as tiers narrow — outer field on either side of upper tiers |
+| BALANCE | Vertical center axis is the pyramid's spine — all tiers center-align |
+
+---
+
+## 2. Container sizing for local PPT inserts
+
+| Use | Canvas | Aspect | Padding |
+|---|---|---|---|
+| Full-bleed pyramid page | 1280×720 | 16:9 | 12% sides, 10% top/bottom |
+| Portrait pyramid block | 600×800 | 3:4 | 12% |
+| Half-page pyramid | 600×700 | ~0.85 | 12% |
+| Square reference pyramid | 700×700 | 1:1 | 12% |
+
+---
+
+## 3. Text-policy variants
+
+### 3.1 `text_policy: none` (default)
+
+Tier labels are added later as SVG overlay. Each tier shows an icon only; the SVG places tier names beside or inside.
+
+Sample fragment:
+
+> NO text, letters, numbers, or tier labels in the image. Each tier contains only one simple iconic symbol; SVG text overlay will add tier names externally.
+
+### 3.2 `text_policy: embedded` (occasional)
+
+Use when the user wants a fully self-contained pyramid. Keep tier names to single English words. High failure risk on 5+ tier pyramids.
+
+---
+
+## 4. Fewshot prompt snippets
+
+**Snippet A — vector-illustration + cool-corporate Maslow pyramid, text_policy: none, 600×800**
+
+> Clean flat vector illustration of a hierarchy pyramid. Five horizontal stepped tiers stacked vertically, each tier centered on the canvas vertical axis and ~18% narrower than the tier below. From bottom to top: tier 1 (foundation, widest) in deeper primary `#1E3A5F`; tier 2 in primary `#3B5478`; tier 3 in lighter primary `#5A7099`; tier 4 in secondary blue tint `#A8BDDD`; tier 5 (apex, narrowest) in accent gold `#D4AF37`. Each tier has one simple white iconic symbol centered — a brick (physiological), a shield (safety), a heart (belonging), a trophy (esteem), a star (self-actualization). Thin secondary cream `#F8F9FA` dividers separate the tiers. Background secondary cream. Composed as a 600×800 portrait pyramid block with 12% padding. NO text or labels — SVG will overlay tier names. Color values are rendering guidance only.
+
+**Snippet B — 3d-isometric + tech-neon capability stack, text_policy: none, 700×700**
+
+> 3D isometric illustration of a software capability stack — four stepped layers stacked vertically in true 30°/30°/30° projection, each layer narrower than the one below, slightly offset to suggest depth. Bottom layer (widest, foundation) in deep primary navy `#0A0E27`; layer 2 in primary electric blue `#0EA5E9`; layer 3 in accent vivid cyan `#06B6D4`; top layer (narrowest, apex) in bright accent white-cyan `#A5F3FC` with subtle outer glow. Each layer's top face carries one simple iconic symbol in white — a server, a database icon, an API connector, a sparkle. Soft 8% drop shadow under the stack. Background secondary deep navy. Composed as a 700×700 reference pyramid block with 12% padding. NO text in the image. Color values are rendering guidance only.
+
+---
+
+## 5. Common failure modes
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| Tiers same width (looks like a stack of bars) | Narrowing rule omitted | "Each tier is 15-20% narrower than the tier below — the pyramid must visibly narrow upward" |
+| Pyramid inverted (narrowing downward) | Direction reversed | "Pyramid narrows UPWARD — widest tier at the bottom (foundation), narrowest at the top (apex)" |
+| Tiers off-center | Center-axis rule omitted | "All tiers center-align on the canvas vertical axis — the pyramid is symmetrical left-right" |
+| Confused with funnel | Metaphor wrong | "Pyramid narrows UPWARD for hierarchy/value stacking, not downward for conversion filtering" |
+| Wrong number of tiers | Count drifted | Explicitly state "exactly N tiers" |
+
+---
+
+## 6. When to switch away from pyramid
+
+- If structure is **narrowing downward (conversion)** → `funnel`
+- If structure is **central hub + radial** → `framework`
+- If structure is **2×2 quadrant grid** → `matrix`
+- If chronological progression → `timeline`
+- If closed loop → `cycle`
+- If linear sequential → `flowchart`