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_gen): three-dimension prompt system (rendering × palette × type)
hugohe3e51143202e2e
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 65f485b7..9a4919e3 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -8,194 +8,227 @@ Role definition for the **AI image generation path**: convert each `Acquire Via:----## 1. Unified Prompt Structure+## 0. Core Principle — All AI Images Are Local Inserts-### 1.1 Standard Output Format+**HARD RULE**: AI-generated images in PPT Master are **local visual blocks** embedded inside SVG pages (left-half illustration, hero banner, background under text, accent spot). They are **not** standalone full-page outputs.-Every image becomes one entry under `items[]` in `project/images/image_prompts.json`. See §4 for the full schema and a paste-ready template.+| What this means |+|---|+| Every prompt must produce art that **survives being cropped into a sub-region** of a 16:9 slide |+| Reserve 12-20% inner padding on all sides so content doesn't slam into the container edge |+| Don't ask the model to fill 100% of the canvas with content — leave breathing room |+| The surrounding SVG carries the page's headline / body / labels — your image's job is to **anchor visuals**, not to be the page |-| Field | Required | Description |+**Escape hatch — full-page AI image (rare, ≤5% of pages)**: when the user explicitly requests "this page is one large image" (typical: cover, chapter divider), mark the item `"page_role": "full_page"` in `image_prompts.json`. Default is `"page_role": "local"`. Do not promote a page to `full_page` without an explicit user instruction.++---++## 1. Three Dimensions++Every AI image is described by three orthogonal dimensions. Lock them in this order: **Rendering** (deck-wide) → **Palette** (deck-wide) → **Type** (per image).++| Dimension | Decides | When fixed ||---|---|---|-| `filename` | yes | Output filename with extension, e.g. `cover_bg.png` |-| `prompt` | yes | Subject + style + color + composition + quality, assembled per §1.2 |-| `aspect_ratio` | yes | One of §1.5; passed to `image_gen.py --aspect_ratio` |-| `status` | yes | `Pending` for new entries — CLI flips to `Generated` / `Failed` |-| `purpose` | no | Which slide / what function (audit only) |-| `type` | no | `Background` / `Photography` / `Illustration` / `Diagram` / `Decorative` |-| `image_size` | no | `512px` / `1K` / `2K` / `4K`; overrides CLI `--image_size` |-| `alt_text` | no | Caption for accessibility |-| `model` | no | Per-entry model override |--### 1.2 Prompt Components--| Component | Description | Example |-|-----------|-------------|---------|-| Subject description | Core content | `Abstract geometric shapes`, `Team collaboration scene` |-| Style directive | Visual style | `flat design`, `3D isometric`, `watercolor style` |-| Color directive | Color scheme | `color palette: navy blue (#1E3A5F), gold (#D4AF37)` |-| Composition directive | Layout ratio | `16:9 aspect ratio`, `centered composition` |-| Quality directive | Resolution quality | `high quality`, `4K resolution`, `sharp details` |--### 1.3 Style Keywords Quick Reference--| Design Style | Recommended Image Style | Core Keywords |-|-------------|------------------------|---------------|-| General Versatile | Modern illustration, flat design | `modern`, `flat design`, `gradient`, `vibrant colors` |-| General Consulting | Clean professional, corporate | `professional`, `clean`, `corporate`, `minimalist` |-| Top Consulting | Premium minimal, abstract geometric | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |-| Technology / SaaS | Futuristic, digital | `futuristic`, `digital`, `tech grid`, `circuit pattern`, `neon accents`, `dark background` |-| Education / Training | Friendly, instructional | `friendly`, `instructional`, `whiteboard style`, `pastel colors`, `simple shapes` |-| Marketing / Branding | Bold, energetic | `bold`, `energetic`, `dynamic composition`, `vivid colors`, `action-oriented` |-| Healthcare / Medical | Clean, reassuring | `clean`, `clinical`, `soft blue-green palette`, `organic curves`, `reassuring` |-| Finance / Banking | Conservative, trustworthy | `conservative`, `trustworthy`, `blue-gray palette`, `structured`, `precise` |-| Creative / Design | Artistic, experimental | `artistic`, `experimental`, `asymmetric`, `textured`, `hand-crafted feel` |--### 1.4 Color Integration Method--Extract colors from design spec, convert to prompt directives:+| **Rendering** | Visual style family (vector / sketch-notes / 3d-isometric / corporate-photo / …) | Once per deck — every AI image in the deck shares one rendering |+| **Palette** | How the deck's HEX colors are *used* (proportion + role + temperament). HEX values come from `design_spec.colors`, not from the palette | Once per deck |+| **Type** | What the image's internal composition looks like (background / hero / infographic / framework / comparison / timeline / scene / flowchart / typography) | Per image |-```-Primary: #1E3A5F (Deep Navy) → "deep navy blue (#1E3A5F)"-Secondary: #F8F9FA (Light Gray) → "light gray (#F8F9FA)"-Accent: #D4AF37 (Gold) → "gold accent (#D4AF37)"+> **What rendering vs palette means**: rendering is *how the image is drawn* (line quality, texture, depth). Palette is *how colors are distributed and behave* (which color dominates, which is accent, what proportion). The HEX values come from Strategist; palette is the **usage contract** for those HEX values.-Full directive: "color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"-```+### 1.1 Where to find each dimension-### 1.5 Canvas Format & Aspect Ratio+| Reference | Loaded |+|---|---|+| [`image-renderings/_index.md`](./image-renderings/_index.md) — rendering catalog + auto-selection table | Always (Step 1 below) |+| [`image-palettes/_index.md`](./image-palettes/_index.md) — palette catalog + auto-selection table | Always (Step 1 below) |+| [`image-type-templates/_index.md`](./image-type-templates/_index.md) — type catalog + auto-selection table | Always (Step 1 below) |+| `image-renderings/<chosen>.md` | After Step 2 picks the rendering — only the chosen one |+| `image-palettes/<chosen>.md` | After Step 2 picks the palette — only the chosen one |+| `image-type-templates/<chosen>.md` | After Step 3 picks the type per image — only the types actually used |-| Canvas Format | Background Aspect Ratio | Recommended Resolution |-|--------------|------------------------|----------------------|-| PPT 16:9 | 16:9 | 1920x1080 or 2560x1440 |-| PPT 4:3 | 4:3 | 1600x1200 |-| Xiaohongshu (RED) | 3:4 | 1242x1660 |-| WeChat Moments | 1:1 | 1080x1080 |-| Story | 9:16 | 1080x1920 |+**Hard rule — on-demand loading**:-> Supported aspect ratios: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` (Gemini also supports `1:4`, `1:8`, `4:1`, `8:1`)+- Read the three `_index.md` files once at role entry.+- After locking dimensions, read **only** the specific rendering / palette / type files you selected.+- **Never** glob-read an entire subdirectory (`image-renderings/*.md` is forbidden). Token cost balloons and the AI loses focus.-### 1.6 Multi-Image Coherence Strategy+----When generating multiple images for a single deck, visual coherence is critical. Use a **Deck Style Anchor** — a shared prefix of 15-25 words prepended to every image prompt.+## 2. Workflow-**Construction**: Combine style keywords (Section 1.3) + color directive (Section 1.4) + quality directive into one reusable prefix.+### Step 1 — Load the dimension indices-**Example**:-```-Deck Style Anchor:-"modern flat design illustration, color palette: deep navy (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37), clean minimalist, high quality, 4K"+Read all three index files. They are short (~50 lines each) and contain auto-selection tables that let you map `design_spec` signals → dimension values without reading every detail file.-Image 1 prompt: [Deck Style Anchor], abstract technology network showing connected nodes...-Image 2 prompt: [Deck Style Anchor], team of professionals collaborating at a desk...-Image 3 prompt: [Deck Style Anchor], growth chart with upward trending line...```+read_file references/image-renderings/_index.md+read_file references/image-palettes/_index.md+read_file references/image-type-templates/_index.md+```++### Step 2 — Lock deck-wide rendering + palette++From `design_spec.md`:++| Signal | Maps to |+|---|---|+| `d. Style` mode + descriptor (e.g. "Top Consulting + minimal") | Rendering (consult renderings `_index.md` auto-selection table) |+| `e. Color Scheme` (HEX) + content vibe | Palette (consult palettes `_index.md` auto-selection table) |+| `f. Icon library` | Sanity check: chosen rendering should be compatible with the icon library's visual weight |++If the auto-selection table surfaces multiple candidates, pick the first; do not present a choice to the user (Strategist already locked downstream style).++Then `read_file` the **single chosen** rendering file and the **single chosen** palette file. These two files give you:++- The 80-120 word style paragraph (rendering)+- The proportion / role / temperament rules for the deck's three HEX values (palette)+- Two ready-to-paste prompt snippets per file (fewshot)++### Step 3 — Per-image type + assembly++For each `Acquire Via: ai` row in `design_spec.md §VIII`:++1. **Determine type** by matching the row's `Purpose` against types `_index.md` auto-selection table (cover background → `background`; product launch hero → `hero`; methodology visualization → `framework`; etc.)+2. **Determine `text_policy`** — `none` if the image is a backdrop under SVG text (the default for `background` type, and the safest choice for most images). `embedded` if the image is meant to carry visible keywords/labels itself (rare; typical for sketch-notes / ink-notes hand-lettered blocks).+3. `read_file references/image-type-templates/<type>.md` (only if not already read — types are commonly reused across images in one deck)+4. **Assemble the prompt** by combining:+ - The rendering's style paragraph (from Step 2)+ - The palette's proportion + role rules applied to the deck's HEX values (from Step 2)+ - The type's structural layout (from Step 3)+ - The image's specific `Reference` intent (from `design_spec.md §VIII`)+ - The container sizing guidance from the type file (so the model knows it's painting a local block, not a full canvas)+ - The hard rules from §3 below (HEX-not-as-text, simplified figures, text policy)++The assembled prompt is **one cohesive paragraph**, not a bulleted list of tags. See §1.2 for the assembly template.-**Exception**: Background images may replace style keywords with `background`, `backdrop`, `negative space for text overlay` while keeping the same color directive. This ensures color consistency without compromising background functionality.+### Step 4 — Write the manifest and generate-**Rule**: Set `deck_style_anchor` once at the manifest's top level (§4), then prepend its text to every `items[].prompt` value.+Write `project/images/image_prompts.json` per §4. Then run `image_gen.py --manifest` (§3.2 Path A). The CLI iterates `items[]`, writes status back, and re-renders the Markdown sidecar.----## 2. Image Type Classification & Handling+## 1.2 Prompt Assembly Template-### Type Determination Flow+Every assembled prompt follows this paragraph structure. **Write prose, not tag soup**.-1. Full-page / large-area backdrop → **Background** (2.1)-2. Real scenes / people / products → **Photography** (2.2)-3. Flat / illustration / cartoon style → **Illustration** (2.3)-4. Process / architecture / relationships → **Diagram** (2.4)-5. Partial decoration / texture → **Decorative Pattern** (2.5)+```+[Rendering style paragraph — 80-120 words from the chosen rendering file].+[Palette behavior — apply the chosen palette's proportion + role rules to the deck's HEX values, e.g. "primary #1E3A5F dominates as the main shape, secondary #F8F9FA provides 60% breathing space, accent #D4AF37 appears in one or two emphasis points only"].+[Type-specific composition — from the chosen type file, e.g. "central hub node with four radiating satellite nodes connected by clean lines"].+[Image-specific subject — translated from the row's Reference intent into concrete visual nouns].+[Container reminder — "composed as a local visual block with 15% padding on all sides, designed to be embedded within a slide region of roughly {W}x{H}px, leaves negative space around edges"].+[Hard rules — see §3].+```++**Word budget**: 150-250 words for `text_policy: none` images, 180-300 words for `text_policy: embedded` images.-### 2.1 Background+**Forbidden — tag-soup prompts**:++```+❌ "modern, flat design, gradient, vibrant, professional, clean, 4K, high quality"+```-**Identifying characteristics**: Full-page background for covers or chapter pages; must support text overlay+This produces generic, model-average output. The model is not weighting your tags — write **one coherent visual scene** instead.-| Key Point | Description |-|-----------|-------------|-| Emphasize background nature | Add `background`, `backdrop` |-| Reserve text area | `negative space in center for text overlay` |-| Avoid strong subjects | Use abstract, gradient, geometric elements |-| Low-contrast details | `subtle`, `soft`, `muted` |+----**Template**: `Abstract {theme element} background, {style} style, {primary color} to {secondary color} gradient, subtle {decorative elements}, clean negative space in center for text overlay, {aspect ratio} aspect ratio, high resolution, professional presentation background`+## 3. Global Hard Rules-### 2.2 Photography+These rules apply to **every** prompt regardless of dimension choices. Append them as a closing sentence to every assembled prompt.-**Identifying characteristics**: Real scenes, people, products, architecture — photographic quality+### 3.1 HEX is rendering guidance, not text-| Key Point | Description |-|-----------|-------------|-| Emphasize realism | `photography`, `photorealistic`, `real photo` |-| Lighting effects | `natural lighting`, `soft shadows`, `studio lighting` |-| Background handling | `white background` / `blurred background` / `contextual setting` |-| People diversity | `diverse`, `professional attire` |+Image generation models occasionally paint color names and HEX values as **visible labels in the image** (a `#1E3A5F` swatch literally drawn as the string "#1E3A5F"). This destroys the image.-**Template**: `{subject description}, professional photography, {lighting type} lighting, {background type} background, color grading matching {color scheme}, high quality, sharp focus, 8K resolution`+**Append to every prompt**:-### 2.3 Illustration+> Color values (HEX codes like #1E3A5F) and color names are rendering guidance only — do NOT display HEX codes, color names, or palette labels as visible text anywhere in the image.-**Identifying characteristics**: Flat design, vector style, cartoon, concept diagrams+### 3.2 Simplified human figures, no realistic faces-| Key Point | Description |-|-----------|-------------|-| Specify style | `flat design`, `isometric`, `vector style`, `hand-drawn` |-| Simplify details | `simplified`, `clean lines`, `minimal details` |-| Unified palette | Strictly use design spec colors |-| Background choice | `white background` or `transparent background` |+When the image contains people:-**Template**: `{subject description}, {illustration style} illustration style, {detail level} with clean lines, color palette: {color list}, {background type} background, professional {purpose} illustration`+> Human figures appear as simplified stylized silhouettes or symbolic representations — no photorealistic faces, no detailed anatomy, no celebrity likeness. Express role/emotion through posture, attire, and simple gestures.-### 2.4 Diagram+Exception: when the chosen rendering is `corporate-photo`, photorealism is intentional — replace the above with: `Diverse, professionally attired subjects. Editorial photography style, natural composition`.-**Identifying characteristics**: Flowcharts, architecture diagrams, concept relationship maps, data visualizations+### 3.3 Text policy — none vs embedded-| Key Point | Description |-|-----------|-------------|-| Clear structure | `clear structure`, `organized layout`, `logical flow` |-| Connection representation | `arrows indicating flow`, `connecting lines` |-| Academic / professional feel | `suitable for academic publication`, `professional diagram` |-| Light background | `white background` or `light gray background` |+| `text_policy` | What the image contains | Append to prompt |+|---|---|---|+| `none` (default for most images) | **Zero** text, letters, numbers, labels | "NO text of any kind. No letters, numbers, signs, watermarks, labels, or written symbols anywhere in the image. Clean negative space ready for SVG text overlay." |+| `embedded` (rare — sketch-notes, ink-notes, infographic with hand-lettered keywords) | A small number of short keyword labels rendered as part of the artwork | "Minimal hand-lettered keywords only — 1-5 short words total, each ≤2 words. Use English for keywords (most models render English text reliably; CJK characters are often malformed). No long sentences, no paragraphs, no numbers." |-**Template**: `{diagram type} diagram showing {content description}, {component description} connected by {connection method}, {style} style with {color scheme}, white background, clear labels, professional technical diagram`+**CJK warning**: most image models cannot render Chinese characters correctly. For `text_policy: embedded` on a CJK-language deck, either (a) use English keywords, or (b) accept that the model will produce garbled-looking glyphs and the user must regenerate or fix manually.-### 2.5 Decorative Pattern+### 3.4 No brand names or trademarks in the subject-**Identifying characteristics**: Partial decoration, textures, borders, divider elements+> The image must not depict identifiable brand logos, trademarks, or product likenesses unless the row's Reference explicitly names a real brand asset the user owns.-| Key Point | Description |-|-----------|-------------|-| Repeatability | `seamless`, `tileable`, `repeatable` (if needed) |-| Understated support | `subtle`, `understated`, `supporting element` |-| Transparency-friendly | `transparent background` or `isolated element` |-| Small-size readability | Consider legibility at small dimensions |+### 3.5 Deck-wide visual coherence-**Template**: `{pattern type} decorative pattern, {style} style, {color scheme}, {background type} background, subtle and elegant, suitable for {purpose}`+Every AI image in one deck shares **one** rendering and **one** palette. Mixing renderings across images in the same deck destroys visual coherence. If a single image truly needs a different rendering (e.g. a corporate-photo team shot alongside otherwise vector-illustration imagery), record this as an exception in the row's `Reference` and isolate it to that one image.----## 3. Generation Workflow+## 4. Manifest Schema-### 3.1 Prompt Generation Phase+Write `project/images/image_prompts.json` with this shape:-For each image with `Acquire Via: ai` and `Status: Pending`:+```json+{+ "project": "{project_name}",+ "generated_at": "{ISO-8601 date}",+ "deck_rendering": "vector-illustration",+ "deck_palette": "cool-corporate",+ "color_scheme": {+ "primary": "#1E3A5F",+ "secondary": "#F8F9FA",+ "accent": "#D4AF37"+ },+ "items": [+ {+ "filename": "cover_bg.png",+ "purpose": "Cover background (Slide 01)",+ "type": "background",+ "page_role": "local",+ "text_policy": "none",+ "aspect_ratio": "16:9",+ "image_size": "2K",+ "prompt": "{fully assembled paragraph per §1.2}",+ "alt_text": "Modern tech abstract background with deep blue gradient and digital waves",+ "status": "Pending"+ }+ ]+}+```-1. **Determine type** → Background / Photography / Illustration / Diagram / Decorative-2. **Understand purpose** → Which page? What function?-3. **Analyze the Reference field** → User's intent description-4. **Apply type-specific key points** → Reference §2's table for that type-5. **Generate optimized prompt** → §1.1 schema; prepend the §1.6 Deck Style Anchor-6. **Save manifest** → **Must** write to `project/images/image_prompts.json` with `status: "Pending"` for every new entry-7. **Render Markdown sidecar** → **Must** run `python3 scripts/image_gen.py --render-md project/images/image_prompts.json` to produce the read-only `image_prompts.md` view+### Field reference-**Hard rule**: `image_prompts.md` is auto-generated. Never hand-edit it — re-run `--render-md` (or `--manifest`, which re-renders on completion) to refresh.+| Field | Required | Source | Description |+|---|---|---|---|+| `deck_rendering` | yes | Step 2 lock | Single rendering name shared by all items in this deck |+| `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[].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` |+| `items[].prompt` | yes | §1.2 assembly | The full assembled paragraph |+| `items[].image_size` | no | Container sizing | `512px` / `1K` / `2K` / `4K` |+| `items[].alt_text` | no | Accessibility | Short caption |+| `items[].status` | yes | CLI manages | `Pending` initially; CLI updates to `Generated` / `Failed` / `Needs-Manual` |++> Existing manifests without `deck_rendering` / `deck_palette` / `type` / `page_role` / `text_policy` remain valid — older items default to `page_role: local`, `text_policy: embedded` for backward compatibility.-> The JSON manifest is machine-consumed by `image_gen.py --manifest`. The Markdown sidecar is the human-readable / paste-ready fallback used in Offline Manual Mode (§3.2).+----### 3.2 Image Generation Phase+## 3.2 Generation Execution-> Prerequisite: §3.1 must be complete; `images/image_prompts.json` must exist and validate.+> Prerequisite: §2 Steps 1-3 complete; `images/image_prompts.json` exists and validates.-#### Path Selection (Deterministic)+### Path Selection (Deterministic)C (AI-generated) supports three implementation modes sharing one `image_prompts.json` source:@@ -213,11 +246,11 @@ C (AI-generated) supports three implementation modes sharing one `image_prompts.- not configured → skip Path A, automatically fall back to Path B.3. If Path B also fails or the host lacks native image generation → fall through to Offline Manual Mode.-**Hard rule**: Step 5 is execution, not re-decision. Never present an interactive choice between paths here — image strategy was locked in Strategist Step 4 h item.+**Hard rule**: Step 4 is execution, not re-decision. Never present an interactive choice between paths here — image strategy was locked in Strategist Step 4 h item.> All three modes share one output contract: file at `project/images/<filename>`. Step 6 SVG references are mode-agnostic.-#### Path A — `image_gen.py --manifest` (Default)+### Path A — `image_gen.py --manifest` (Default)```bashpython3 scripts/image_gen.py \@@ -271,7 +304,7 @@ Precedence:- Interrupting mid-run is safe — completed items keep `status: Generated` and are skipped on re-run- On normal completion the Markdown sidecar is re-rendered automatically; if the run is interrupted, run `--render-md` manually to refresh the sidecar-#### Path B — Host-Native Image Tool (On Explicit User Request)+### Path B — Host-Native Image Tool (On Explicit User Request)Triggered only when the user explicitly asks the skill to use the host's built-in image generation (e.g. Codex, Antigravity, or any other host that provides a native image tool).@@ -280,13 +313,13 @@ Triggered only when the user explicitly asks the skill to use the host's built-i- After each placement, set the corresponding item's `status` to `Generated` in the manifest- Executor downstream is path-agnostic — no spec change required between Path A and Path B-#### Offline Manual Mode (C's third implementation mode)+### Offline Manual Mode (C's third implementation mode)**Trigger**: Both Path A and Path B fail or are unavailable.**Workflow** (no user prompting; system enters this mode automatically):-1. Verify `images/image_prompts.json` was written in §3.1+1. Verify `images/image_prompts.json` was written2. Set `status: "Needs-Manual"` on every affected item per [`image-base.md`](./image-base.md) §63. Continue to Step 6 — SVG references `images/<filename>` optimistically; Step 7 entry verifies presence4. Print one consolidated handoff to the user:@@ -320,69 +353,40 @@ If Path A's backend fails twice in a row:----## 4. Manifest Template--Write `project/images/image_prompts.json` with this shape. Top-level fields are audit-only; `items[]` is the machine contract.--```json-{- "project": "{project_name}",- "generated_at": "{ISO-8601 date}",- "color_scheme": {- "primary": "#1A3A5C",- "secondary": "#F8F9FA",- "accent": "#E8A838"- },- "deck_style_anchor": "{15–25 word prefix per §1.6}",- "items": [- {- "filename": "cover_bg.png",- "purpose": "Cover background (Slide 01)",- "type": "Background",- "aspect_ratio": "16:9",- "image_size": "2K",- "prompt": "{deck_style_anchor}, abstract futuristic background with flowing digital waves, deep navy gradient #1A3A5C to midnight, soft particle accents, clean center for text overlay, cinematic, 4K",- "alt_text": "Modern tech abstract background with deep blue gradient and digital waves",- "status": "Pending"- }- ]-}-```--**Field reference**: see §1.1 for required vs optional. The CLI rewrites each item's `status` (and adds `last_error` on failure) — do not hand-edit those while a run is in flight.--**Paste-ready for manual mode**: each `items[].prompt` is a complete, self-contained prompt; copy it directly into ChatGPT / Gemini / Midjourney when running Offline Manual Mode (§3.2).-------## 5. Common Issues+## 5. Common Issues & Variant Workflow### Default Inference When No `Reference` Provided-| Purpose | Default Inference |-|---------|------------------|-| Cover background | Abstract gradient background, reserve central text area |-| Chapter page background | Clean geometric pattern, monochrome focus |-| Team introduction page | Team collaboration scene illustration (flat style) |-| Data display page | Clean geometric pattern or solid color background |-| Product showcase | Product photography style, white or gradient background |+| Purpose | Default Inference (assembled from rendering + palette + type) |+|---------|---------------------------------------------------------------|+| Cover background | `type: background`, `text_policy: none` — abstract atmospheric block matching deck rendering, generous center negative space |+| Chapter divider background | `type: background`, `text_policy: none` — slightly more structured than cover (geometric anchor permitted) |+| Methodology / framework illustration | `type: framework`, `text_policy: none` — central node + radiating satellites, no labels (SVG carries names) |+| Process / workflow illustration | `type: flowchart`, `text_policy: none` — sequential blocks with arrows |+| Before/After or two-option page | `type: comparison`, `text_policy: none` or `embedded` |+| Team / lifestyle photo | `type: scene`, `text_policy: none`, rendering should be `corporate-photo` or `warm-scene` |+| Big-number / hero quote block | `type: typography` or `hero`, `text_policy: embedded` (the number/keyword is the visual) |### When Images Are Unsatisfactory-Diagnose the problem category and apply a targeted prompt fix:+Diagnose the failure category, adjust the **one specific dimension** responsible, do not rewrite the whole prompt.-| Problem | Diagnosis | Prompt Adjustment |-|---------|-----------|-------------------|-| Wrong style | Image looks photorealistic when flat design was intended | Change style directive: replace `photography` with `flat design illustration` |-| Wrong colors | Colors don't match the design spec palette | Strengthen color directive: add explicit HEX codes, repeat color names |-| Wrong composition | Subject is off-center or layout doesn't fit the slide | Adjust composition directive: add `centered composition`, `rule of thirds`, or `wide negative space on left` |-| Wrong subject | Image depicts something different from what was described | Rewrite subject description with more specificity and concrete details |-| Low quality | Image is blurry, has artifacts, or lacks detail | Add `highly detailed, sharp focus, professional quality, 8K resolution` |+| Symptom | Most likely cause | Adjustment |+|---|---|---|+| Image looks generic, model-average | Tag-soup prompt | Rewrite as one coherent paragraph per §1.2 |+| Wrong style family (looks photorealistic when flat was intended) | Rendering mismatch or rendering paragraph diluted | Reaffirm chosen rendering's style paragraph at the top of the prompt |+| Colors don't match deck | HEX not echoed in prompt, or palette proportion rule omitted | Repeat HEX values 2-3 times in the prompt; restate palette proportion rule |+| Hex code or color name visible as text in image | Missing §3.1 closing sentence | Append the §3.1 hard rule verbatim |+| Garbled letters in supposedly text-free image | `text_policy: none` rule too weak | Strengthen with explicit list: "no letters, no numbers, no words, no signs, no labels, no captions, no watermarks" |+| Composition too busy, no room for SVG overlay | Missing container reminder | Add explicit "leaves at least 30% negative space in the {center / left third / lower band} for text overlay" |+| Subject vague | Reference field too abstract | Rewrite reference with concrete nouns (verbs + objects) |+| Faces too realistic / uncanny | §3.2 rule omitted, or rendering is photo-incompatible | Either append §3.2, or switch rendering to a non-photo family |**Variant workflow**:+1. Set the unsatisfactory item's `status` back to `Pending` and update its `prompt` in place2. Re-run `image_gen.py --manifest` — only that item is re-processed-3. If trying multiple stylistic approaches, append additional items with distinct filenames (e.g. `cover_bg_v2.png`) rather than overwriting+3. To try multiple stylistic approaches, append additional items with distinct filenames (e.g. `cover_bg_v2.png`) rather than overwriting---@@ -390,5 +394,8 @@ Diagnose the problem category and apply a targeted prompt fix:- Generating prompts for `web` rows — those go through [`image-searcher.md`](./image-searcher.md)- Brand names or HEX codes inside the subject description (degrades output)-- Mixed Deck Style Anchors across images in the same deck (breaks coherence)+- Mixing renderings or palettes across images in the same deck+- Tag-soup prompts (keyword lists separated by commas without a coherent visual scene)+- Globbing `image-renderings/*.md` or any subdirectory — read only the chosen file- Placing an image without updating its `image_prompts.json` `status` and the resource list status+- Promoting a page to `page_role: full_page` without explicit user instructiondiff --git a/skills/ppt-master/references/image-palettes/_index.md b/skills/ppt-master/references/image-palettes/_index.mdnew file mode 100644index 00000000..b0025c5a--- /dev/null+++ b/skills/ppt-master/references/image-palettes/_index.md@@ -0,0 +1,77 @@+# Palettes — Index++A **palette** is the deck's **color behavior** — proportion, role, temperament. It does **not** supply HEX values; those come from `design_spec.colors`. The palette tells the model how to use the HEX values: which dominates, which carries accent, what proportion the background occupies, what the overall temperament feels like.++> Why this split: SVG renders the HEX precisely from `design_spec`. The AI image must use the **same HEX values** so the image visually belongs in the deck — but the image needs more than a HEX list; it needs a **usage rule**. That's the palette.++## Catalog (10 palettes)++Each palette has its own file with: proportion rules, role assignments, temperament, fewshot snippets, what to avoid.++| Palette | Temperament | Best for |+|---|---|---|+| [cool-corporate](cool-corporate.md) | Stable, professional, restrained | Consulting / B2B / finance |+| [warm-earth](warm-earth.md) | Friendly, grounded, human | Brand / lifestyle / education |+| [tech-neon](tech-neon.md) | Energetic, futuristic, high-contrast | AI / SaaS / product launch |+| [editorial-classic](editorial-classic.md) | Refined, magazine, balanced | Journalism / opinion / culture |+| [macaron](macaron.md) | Soft pastel, gentle, approachable | Education / children / onboarding |+| [mono-ink](mono-ink.md) | High-contrast monochrome with sparse accents | Methodology / Before-After / manifesto |+| [vivid-launch](vivid-launch.md) | Bold, saturated, attention-grabbing | Product launch / marketing / event |+| [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 |++---++## Auto-selection table — `design_spec` → palette++Match `design_spec.md d. Style` + `e. Color Scheme` content vibe. First match wins. If no row matches, default to `cool-corporate`.++| Content vibe / industry | Recommended palette | Alternates |+|---|---|---|+| Consulting / finance / B2B / corporate | `cool-corporate` | `editorial-classic` |+| Tech / SaaS / AI | `tech-neon` | `cool-corporate`, `dark-cinematic` |+| 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` |+| Children / storybook | `macaron` | `warm-earth` |+| Premium / entertainment / film | `dark-cinematic` | `duotone` |+| Cultural / media / cover-art | `duotone` | `editorial-classic` |+| Environment / wellness / outdoor | `nature-organic` | `warm-earth` |+| Finance / journalism / explainer | `editorial-classic` | `cool-corporate` |+| Government / formal | `cool-corporate` | `editorial-classic` |++## Rendering × Palette compatibility++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 | ✓ | ✓✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✗ | ✗ | ✓✓ |++✓✓ recommended | ✓ acceptable | ✗ avoid++## How to use++1. After picking rendering, look up your candidate palette in the auto-selection table.+2. Cross-check the compatibility matrix — if `✗`, pick the alternate.+3. `read_file image-palettes/<chosen>.md`.+4. Apply its proportion + role rules to the deck's HEX values when assembling prompts.++**Lock for the whole deck.**diff --git a/skills/ppt-master/references/image-palettes/cool-corporate.md b/skills/ppt-master/references/image-palettes/cool-corporate.mdnew file mode 100644index 00000000..f7e4a57a--- /dev/null+++ b/skills/ppt-master/references/image-palettes/cool-corporate.md@@ -0,0 +1,76 @@+# Palette: cool-corporate++Stable, professional, restrained. The default palette for consulting / finance / B2B / corporate decks where credibility is the primary visual signal.++> This file describes **color behavior**, not HEX values. The deck's HEX triplet comes from `design_spec.colors` (set by Strategist). cool-corporate tells the model **how to use** those HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Restrained — let the primary blue feel deep but not vivid |+| Brightness contrast | Strong (deep primary against bright secondary) — supports executive readability |+| Color count visible | 3 maximum (primary + secondary + accent); no fourth color creeps in |+| Mood | Confident, calm, deliberate, slightly serious |+| Material | Flat — no glossy, no metallic, no plastic |++## Proportion rule (60-30-10, applied to the deck's HEX)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / negative space | **60-70%** | `secondary` | Calm field. Usually pale (gray, off-white, very light blue). Carries the page's breathing room. |+| Main subject / dominant shape | **25-30%** | `primary` | The deep blue / navy / dark teal that anchors the image. Used in confident solid blocks, not as a tint. |+| Emphasis / call-attention | **3-7%** | `accent` | One or two elements only — a single highlighted node, a thin key line, an emphasized icon stroke. Never more than 5-7% of the canvas. |++> **Hard rule**: if accent exceeds ~7%, the deck loses its corporate temperament and starts to feel promotional. When in doubt, reduce accent presence.++## Role semantics++- **Primary** carries trust, structure, the spine of the visual. Use it for: dominant forms, vertical/horizontal anchor lines, key icon fills, foundational geometry.+- **Secondary** carries breathing space. Use it for: backgrounds, gutters, secondary blocks, subtle dividers. It should feel **almost invisible** in a good cool-corporate image.+- **Accent** carries direction — it tells the viewer's eye where to land. Use it for: the single most important data point, the chosen "this is the conclusion" element, a thin accent line under a key area.++## How to phrase it in a prompt++Combine the proportion rule + role semantics + the deck's actual HEX:++> "Color behavior is restrained-corporate: secondary `#F8F9FA` occupies 60-70% of the canvas as calm background; primary `#1E3A5F` carries the main shape and dominant elements; accent `#D4AF37` appears only in one or two emphasis points totaling under 5% of the area. No fourth color. Flat solid fills only — no gradients, no metallic, no glossy reflections."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ vector-illustration | Default pairing — flat shapes carry the restraint |+| ✓✓ flat | Similar feel, slightly more decorative |+| ✓✓ 3d-isometric | Works well — keep shadows soft and 8% opacity |+| ✓✓ digital-dashboard | Natural fit for data products |+| ✓✓ blueprint | Good for technical architecture |+| ✓✓ corporate-photo | Photography with cool color grading |+| ✓✓ editorial | Magazine restraint matches palette restraint |+| ✗ sketch-notes / fantasy-animation / pixel-art | Temperament conflict — choose `warm-earth` or `macaron` for those renderings |+| ✗ dark-cinematic combinations | Dark-cinematic is a different palette — don't try to merge |++## Fewshot prompt snippets++**Snippet A — applied to a vector-illustration background**++> [...rendering paragraph...] Color behavior is restrained-corporate: secondary light gray `#F8F9FA` carries 65% of the canvas as calm breathing space across the upper two-thirds; primary deep navy `#1E3A5F` forms a confident diagonal block across the lower portion (about 28% area); accent gold `#D4AF37` appears only as one thin horizontal line and a single small geometric dot, together under 5% of the area. No additional colors. [...container guidance...]++**Snippet B — applied to a digital-dashboard product showcase**++> [...rendering paragraph...] Color behavior is restrained-corporate dashboard: secondary `#F8F9FA` dominates the canvas as the UI surface (about 70%); primary `#1E3A5F` carries the main data chart's bars and the dominant card header (25%); accent `#D4AF37` is reserved for one highlighted metric — a single arrow indicator or one emphasized data point — totaling under 5% of the area. Soft 8% drop shadows under cards. No gradients within fills. [...container guidance...]++## What to avoid++- **Vibrant accent**: accent in cool-corporate is structurally a small percentage, not a bright burst. If the HEX `accent` is itself highly saturated (e.g. neon yellow), reduce its area further — never increase it.+- **Equal-share triplet**: when all three colors appear in roughly equal area, the image looks like a children's flag, not a corporate visual. Force the 60-30-10 split.+- **Fourth color**: don't let the model introduce a green, a pink, or a darker complement. Reaffirm the three HEX values 2-3 times in the prompt.+- **Bright background**: secondary should be near-white, not the primary brand color. cool-corporate's breathing room is what makes it corporate.+- **Metallic / glossy**: cool-corporate is flat. Switch palette to `dark-cinematic` if a premium glossy treatment is wanted.++## When to switch away from cool-corporate++- If the deck is **warm / personal / brand-storytelling**, switch to `warm-earth` or `editorial-classic`+- If the deck is **AI / SaaS / energetic tech**, `tech-neon` carries more presence+- If the deck is **methodology / mindset shift**, `mono-ink` is sharper+- If the deck is **education / approachable**, `macaron` is softerdiff --git a/skills/ppt-master/references/image-palettes/dark-cinematic.md b/skills/ppt-master/references/image-palettes/dark-cinematic.mdnew file mode 100644index 00000000..36d18711--- /dev/null+++ b/skills/ppt-master/references/image-palettes/dark-cinematic.md@@ -0,0 +1,76 @@+# Palette: dark-cinematic++Premium, atmospheric, low-light. The "dark mode" palette — used for premium product launches, film / entertainment decks, evening / nightlife themes, sophisticated tech that wants cinema mood. Distinguished by **deep dark background** with carefully placed bright accents.++> This file describes **color behavior**, not HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Mid to high on accents; dark background provides contrast |+| Brightness contrast | Maximum — bright element on deep dark field |+| Color count visible | 2-3 (dark background + 1-2 bright accents) |+| Mood | Premium, cinematic, sophisticated, slightly mysterious |+| Material | Deep matte or subtle metallic, with implied light source |++## Proportion rule (65-25-10, dark-dominant)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Dark background | **60-70%** | Deep dark — `#0A0E27` / `#1A1A1A` / dark brand neutral | The cinema field. May override deck's secondary if it isn't dark. |+| Primary bright element | **20-30%** | `primary` (brightness-boosted if originally muted) | The lit subject — confident vivid against the dark field. |+| Accent glow / highlight | **5-15%** | `accent` | Small concentrated bright pop — often with implied glow / luminance. |++## Special: dark-cinematic may override deck background++dark-cinematic, like mono-ink, may **override `design_spec.colors.secondary`** if the deck's secondary is light. The dark background is essential to the palette identity. Note this in the prompt:++> "dark-cinematic palette uses a deep dark background `#0A0E27` regardless of deck's secondary HEX — the dark cinema field is the identity. The deck's primary `#XXX` is used as the bright lit subject; the deck's accent `#XXX` carries the glow accent."++## Role semantics++- **Primary** is the lit subject — confident and bright against the dark, often with implied luminance.+- **Background** is the cinema void — deep dark, atmospheric, sometimes with subtle gradient toward even darker corners.+- **Accent** is the glow pop — small, bright, luminous.++## How to phrase it in a prompt++> "Color behavior is dark-cinematic: deep dark background `#0A0E27` covers about 65% of the canvas with subtle gradient toward darker edges. Primary brand teal `#14B8A6` carries the main subject as a bright lit element (about 25%) with implied luminance glow at 8% opacity. Accent vivid gold `#D4AF37` appears as a small concentrated glow point near the focal area (about 10%). The bright primary and accent feel like light sources within the cinematic dark."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ 3d-isometric | Premium dark-mode architecture |+| ✓✓ digital-dashboard | Dark-mode SaaS product |+| ✓✓ corporate-photo | Low-light photography |+| ✓✓ warm-scene | Evening / nightlight scenes |+| ✓✓ screen-print | Cinematic poster |+| ✓ blueprint | Dark-mode schematic |+| ✓ vector-illustration | Acceptable |+| ✗ sketch-notes / fantasy-animation / nature / chalkboard | Wrong temperament |+| ✗ macaron / warm-earth | Wrong brightness identity |++## Fewshot prompt snippets++**Snippet A — applied to a digital-dashboard premium product**++> [...rendering paragraph...] Color behavior is dark-cinematic dashboard: deep dark `#0A0E27` covers about 65% of the surface as the cinema background. Primary bright teal `#14B8A6` carries the main chart bars with implied 8%-opacity glow halo (about 25%). Accent gold `#D4AF37` reserved for one highlighted KPI with stronger glow (about 10%). Card backgrounds are slightly lighter dark `#1E293B` separating cards from the deeper void. Premium, cinematic, sophisticated. [...container guidance...]++**Snippet B — applied to a 3d-isometric premium product launch**++> [...rendering paragraph...] Color behavior is dark-cinematic: deep dark `#0A0E27` covers the background plane and shadowed faces (about 65%). Primary bright teal `#14B8A6` on the lit faces of the central product block with implied luminance halo (about 22%). Accent vivid amber `#D97706` on one corner of the product as a focal glow (about 11%). Soft 8% glow halos around each bright element. Dramatic single-source lighting feel. [...container guidance...]++## What to avoid++- Light backgrounds (defeats the cinematic identity — switch palette)+- Pastel accents (dark-cinematic wants bright vivid against dark)+- More than 2 bright accent colors+- Decorative warmth (mood is sophisticated, not friendly)++## When to switch away++- For light / corporate mood → `cool-corporate` / `editorial-classic`+- For vivid promotional → `vivid-launch`+- For warm story → `warm-earth`diff --git a/skills/ppt-master/references/image-palettes/duotone.md b/skills/ppt-master/references/image-palettes/duotone.mdnew file mode 100644index 00000000..8b614229--- /dev/null+++ b/skills/ppt-master/references/image-palettes/duotone.md@@ -0,0 +1,73 @@+# Palette: duotone++Two-color limited, poster-like. The constrained palette — only two colors plus a background, used for cultural / cover hero / cinematic poster decks where chromatic discipline carries the page.++> This file describes **color behavior**, not HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Variable — both colors are deliberate, neither competes |+| Brightness contrast | Strong between the two colors |+| Color count visible | 2 (+ optional neutral background) |+| Mood | Poster, cinematic, editorial-bold, chromatically disciplined |+| Material | Flat or screen-print textured |++## Proportion rule (60-40 or 50-50, two-color)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Color A (figure / dominant) | **40-60%** | Often `primary` | One of the two duotone colors. Carries the main subject or dominant zone. |+| Color B (ground / secondary) | **40-60%** | Often `accent` (or whatever pairs well with primary) | The complementary color. Carries the rest of the composition. |+| Optional neutral | **0-20%** | Off-white / cream / near-black | Used as separator or small neutral zone. |++**Hard rule**: only 2 colors appear; if the deck's HEX is a triplet, drop secondary or use it as the neutral background only.++## Role semantics++- **Color A** is the figure — the silhouette, the dominant block, the foreground.+- **Color B** is the ground — the background field, the contrasting zone, where Color A lives.+- The choice of pairing matters more than role assignment — pick the two HEX values from the deck that have the strongest duotone tension.++## How to phrase it in a prompt++> "Color behavior is duotone: Color A — deep teal `#0F766E` (the deck's primary) — carries the main subject silhouette and dominant zone (about 50%). Color B — vivid amber `#D97706` (the deck's accent) — carries the background and secondary zone (about 48%). The two colors are the entire palette — no third hue beyond a barely-perceptible neutral 2% in transitional textures."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ screen-print | Direct alignment — duotone is screen-print's signature |+| ✓✓ flat | Bold two-color flat |+| ✓ vector-illustration | Two-color vector |+| ✓ editorial | Two-color editorial spread |+| ✓ blueprint | Two-color schematic |+| ✓ pixel-art | Limited-color retro |+| ✓ chalkboard | Pastel two-color chalk |+| ✗ corporate-photo | Photography can't be duotone (unless duotone-graded) |+| ✗ sketch-notes / fantasy-animation / nature / watercolor | Wrong temperament |+| ✗ digital-dashboard / 3d-isometric | Need more chromatic depth |++## Fewshot prompt snippets++**Snippet A — applied to a screen-print cover poster**++> [...rendering paragraph...] Color behavior is duotone: deep navy `#1E3A5F` carries the lower 55% as a confident block including the silhouette of a stylized mountain. Burnt orange `#C2410C` carries the upper 45% as the sky, with one small near-white circular sun (under 3%). Only these two colors appear in the composition — no third hue. Halftone dot texture at the horizon between the two color zones. Slight color misregistration adds silkscreen authenticity. [...container guidance...]++**Snippet B — applied to a flat editorial two-color spread**++> [...rendering paragraph...] Color behavior is duotone: deep teal `#0F766E` (the deck's primary) carries the left 50% as a flat block with a stylized geometric form. Warm amber `#D97706` (the deck's accent) carries the right 50% as a complementary flat block with a different stylized form. The two colors meet at a clean vertical edge down the center. No third color, no gradients. Editorial poster balance. [...container guidance...]++## What to avoid++- A third color creeping in (defeats duotone discipline)+- Gradients within either color (duotone is flat)+- Too-similar colors with no chromatic tension+- Photo-realistic content (duotone is intentionally stylized)++## When to switch away++- For more color flexibility → any other palette+- For monochrome (one color) → `mono-ink`+- For tech vivid → `tech-neon`diff --git a/skills/ppt-master/references/image-palettes/editorial-classic.md b/skills/ppt-master/references/image-palettes/editorial-classic.mdnew file mode 100644index 00000000..43ea98e8--- /dev/null+++ b/skills/ppt-master/references/image-palettes/editorial-classic.md@@ -0,0 +1,70 @@+# Palette: editorial-classic++Refined, magazine-style, balanced. The premium-restrained palette — used in finance journalism, opinion pieces, sophisticated B2B content, longform commentary. Distinguished from cool-corporate by slightly richer primary tones and more deliberate accent rules.++> This file describes **color behavior**, not HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Moderate — colors are rich but not loud |+| Brightness contrast | Medium-strong — supports editorial readability |+| Color count visible | 3 |+| Mood | Refined, intelligent, magazine, slightly serious |+| Material | Flat with subtle paper texture |++## Proportion rule (55-30-15, with magazine pacing)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / page field | **50-60%** | `secondary` | Warm cream, off-white, or very pale neutral — feels like magazine paper. |+| Main feature / column block | **25-35%** | `primary` | The rich brand tone — deep navy, deep teal, deep burgundy. Used in confident solid blocks or hero subjects. |+| Editorial accent / rule | **10-15%** | `accent` | A small concentrated accent — often a thin horizontal rule, a single highlight, a callout marker. Slightly more visible than cool-corporate's accent. |++## Role semantics++- **Primary** is the editorial voice — confident, anchoring, the column lead. Use it for: dominant text blocks (visually, not literally), hero subjects, the "lead story" element.+- **Secondary** is the magazine paper — warm or cool neutral, slightly textured. Should feel like physical print, not digital.+- **Accent** is the editorial rule — a thin line, a callout dot, a marker. Editorial restraint says: "one accent, used decisively."++## How to phrase it in a prompt++> "Color behavior is editorial-classic: secondary warm cream `#FAF7F2` carries the magazine-paper field across about 55% of the canvas with subtle paper-grain texture at 8% opacity; primary deep navy `#0F2C4C` anchors the dominant column block and hero subject in confident solid tone (about 30%); accent burnt orange `#C2410C` appears as a single thin horizontal rule and one small highlight marker (totaling under 14%). Magazine-considered composition, deliberate breathing room."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ editorial | Perfect alignment |+| ✓✓ vector-illustration | Restrained vector with magazine pacing |+| ✓✓ ink-notes | Editorial restraint + ink-notes formality |+| ✓✓ corporate-photo | Magazine photography |+| ✓ flat | Acceptable — flat is slightly more decorative |+| ✓ blueprint | Works for technical magazine content |+| ✓ screen-print | Editorial poster style |+| ✗ sketch-notes / fantasy-animation / pixel-art | Too playful for editorial restraint |++## Fewshot prompt snippets++**Snippet A — applied to an editorial finance explainer**++> [...rendering paragraph...] Color behavior is editorial-classic: secondary warm cream `#FAF7F2` covers about 55% of the canvas with subtle paper-grain at 8% opacity; primary deep navy `#0F2C4C` carries the dominant data block on the left (about 32%); accent burnt orange `#C2410C` appears as one thin horizontal rule and a single small data marker at the highlighted point (about 12% total). Magazine-spread composition with deliberate gutters. [...container guidance...]++**Snippet B — applied to a corporate-photo magazine hero**++> [...rendering paragraph...] Color behavior is editorial-classic: image is graded toward magazine warmth — cream highlights, deep navy shadows. The subject is graded with primary `#0F2C4C` as dominant shadow tone (about 30%), secondary `#FAF7F2` as soft highlight tone (about 55%), and accent `#C2410C` appearing only as a small contextual detail in the environment (about 13%). Editorial restraint throughout. [...container guidance...]++## What to avoid++- Vibrant / loud accent (editorial-classic is restrained)+- Equal-share triplet (creates carnival, not magazine)+- Too much accent area (defeats editorial restraint)+- Cold sterile background (paper warmth matters)++## When to switch away++- For business consulting / B2B → `cool-corporate`+- For warm storytelling → `warm-earth`+- For methodology / Before-After → `mono-ink`+- For premium / cinematic dark → `dark-cinematic`diff --git a/skills/ppt-master/references/image-palettes/macaron.md b/skills/ppt-master/references/image-palettes/macaron.mdnew file mode 100644index 00000000..554cd1f7--- /dev/null+++ b/skills/ppt-master/references/image-palettes/macaron.md@@ -0,0 +1,72 @@+# Palette: macaron++Soft pastel, gentle, approachable. The signature palette for education, onboarding, children's content, knowledge cards, and warm friendly explainers. Distinguished by **pastel-tinted** versions of the deck's HEX values on a warm cream field.++> This file describes **color behavior**, not HEX values. HEX comes from `design_spec.colors`, but rendered as pastel tints.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Low to moderate — colors are tinted toward pastel |+| Brightness contrast | Soft — gentle transitions, no harsh contrast |+| Color count visible | 3-4 pastel tints + black ink for lines (when paired with sketch-notes) |+| Mood | Gentle, approachable, educational-warm, slightly playful |+| Material | Soft block fills (often hand-painted overshoot quality) |++## Proportion rule (50-40-10, pastel-graded)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / paper field | **45-55%** | `secondary` | Warm cream `#F5F0E8` or near-cream — the "paper" the macarons sit on. May override deck's secondary if it doesn't lean cream. |+| Pastel block fills | **35-45%** | `primary` (pastel-tinted) + 2-3 supporting pastels | The block colors — soft tinted versions of primary, plus complementary pastels (light blue, mint, lavender, peach). Each block fills with its own pastel. |+| Emphasis pop | **5-10%** | `accent` | A small concentrated pop — often used sparingly as the "this is the answer" coral or warm yellow. |++## Role semantics++- **Background** carries warmth and friendliness — should feel like a thoughtful teacher's notebook page.+- **Pastel blocks** carry information zones — each block is a different soft tint, used to differentiate sections without shouting.+- **Accent** is the one warm pop — used 1-2 times max in an entire image, drawing the eye to the key takeaway.++## How to phrase it in a prompt++> "Color behavior is macaron pastel: warm cream paper background `#F5F0E8` covers about 50% of the canvas. Pastel block fills in soft tints — light blue, mint green, lavender, peach — fill the rounded info shapes (about 40% total area, divided across 3-4 blocks). Accent warm coral `#F97316` appears in one or two small emphasis points only (under 10%). All pastel fills have slight hand-painted overshoot beyond their outlines. Soft, friendly, educational temperament throughout."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ sketch-notes | Direct alignment — macaron is the default sketch-notes palette |+| ✓✓ flat | Pastel flat blocks for friendly content |+| ✓✓ vector-illustration | Pastel vector for educational warmth |+| ✓✓ watercolor | Pastel washes pair naturally |+| ✓✓ fantasy-animation | Storybook pastels |+| ✓✓ chalkboard | Pastel chalk on dark slate |+| ✓ pixel-art | Pastel retro |+| ✗ tech-neon / dark-cinematic / blueprint | Wrong temperament |+| ✗ corporate-photo | Photography wants natural color |+| ✗ digital-dashboard | Dashboards want vivid not pastel |++## Fewshot prompt snippets++**Snippet A — applied to a sketch-notes infographic**++> [...rendering paragraph...] Color behavior is macaron pastel: warm cream paper background `#F5F0E8` covers about 50%. Four rounded info boxes filled with soft pastels — light blue (pastel tint of primary `#1E3A5F`), mint (pastel tint of secondary `#F8F9FA` shifted greener), lavender, peach. Each fill has slight hand-painted overshoot beyond its black ink outline. Accent warm coral `#F97316` appears only on one highlighted hand-drawn arrow connecting two boxes (about 6%). Friendly educational temperament. [...container guidance...]++**Snippet B — applied to a flat illustration knowledge card**++> [...rendering paragraph...] Color behavior is macaron pastel for a knowledge-card aesthetic. Warm cream background `#F5F0E8` (about 55%). One large rounded rectangle in pastel mint occupying the lower half (about 30%), with a smaller pastel-peach circle overlapping its upper edge (about 10%). One small accent coral `#F97316` dot at the focal point of the composition (about 5%). All shapes have soft hand-painted overshoot edges. Gentle, knowledge-card feel. [...container guidance...]++## What to avoid++- Saturated full-strength colors (defeats macaron's pastel identity)+- Cool / sterile background (cream warmth is essential)+- Hard digital edges (macaron's softness needs hand-painted feel)+- Heavy accent presence (one pop is enough)++## When to switch away++- For corporate / consulting → `cool-corporate`+- For warm-earth storytelling → `warm-earth`+- For methodology sharpness → `mono-ink`+- For premium dark → `dark-cinematic`diff --git a/skills/ppt-master/references/image-palettes/mono-ink.md b/skills/ppt-master/references/image-palettes/mono-ink.mdnew file mode 100644index 00000000..4356bae3--- /dev/null+++ b/skills/ppt-master/references/image-palettes/mono-ink.md@@ -0,0 +1,77 @@+# Palette: mono-ink++High-contrast monochrome with sparse semantic accents. The most disciplined palette — used for methodology, manifestos, Before-After essays, mindset-shift narratives, professional visual-notes. Distinguished by **black ink on white**, with the deck's accent reserved for semantic meaning only.++> This file describes **color behavior**, not HEX values. mono-ink overrides much of the deck's HEX usage — read carefully.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Extreme contrast (black + white) + low saturation for accents |+| Brightness contrast | Maximum — pure black on pure white |+| Color count visible | Ink (black) + 1-2 semantic accents, total under 10% color area |+| Mood | Professional, manifesto, disciplined, considered |+| Material | Ink on paper |++## Proportion rule (90/10 ink + sparse accent)++| Role | Share | Source | Behavior |+|---|---|---|---|+| Background | **~50-60%** | Pure white `#FFFFFF` | Never replace with deck's secondary; the white is essential to mono-ink identity |+| Ink (lines, fills, text, figures) | **~30-40%** | Near-black `#1A1A1A` | All structural elements; never replaced by deck's primary |+| Semantic accent #1 (e.g. emphasis / risk) | **3-7%** | Maps from `design_spec.accent` if that HEX is in a warm/red family | Reserved for: risks, emphasis points, "this matters" markers. Often coral red `#E8655A` traditionally. |+| Semantic accent #2 (e.g. positive / solution) | **2-5%** | Optional second accent, often muted teal `#5FA8A8` | Reserved for: positive states, solution markers, "after" side of Before-After. |++> **Total color accent must stay under 10% of canvas** — this is what makes mono-ink "mono".++## Special: deviates from deck HEX++mono-ink is the palette **most likely to override `design_spec.colors`**:++- The deck's `primary` HEX is typically **not used** as ink color (mono-ink ink is always near-black, not the deck's brand color)+- The deck's `secondary` HEX is typically **not used** as background (mono-ink background is always pure white)+- The deck's `accent` HEX **is used** — but only in the semantic accent role, with strict <10% area constraint++When proposing mono-ink, the assembled prompt should explicitly note: "mono-ink palette intentionally uses near-black on white as the structural language; the deck's primary `#XXX` and secondary `#XXX` are not represented as image colors. The deck's accent `#XXX` is reserved for the semantic emphasis role under 10% of canvas."++## How to phrase it in a prompt++> "Color behavior is mono-ink: pure white background `#FFFFFF` (about 55%). All structural elements — lines, figures, hand-lettered text, arrows — in near-black ink `#1A1A1A` (about 38%). The deck's accent color `#E8655A` is reserved as the semantic emphasis accent, appearing in 1-3 small focal points totaling under 8% of canvas. No other colors. The deck's primary and secondary HEX values are intentionally not represented as image colors in this palette."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ ink-notes | Direct alignment — mono-ink is the default ink-notes palette |+| ✓✓ editorial | Magazine restraint + ink discipline |+| ✓ vector-illustration | Acceptable but loses the hand-drawn quality |+| ✓ blueprint | Schematic restraint |+| ✗ sketch-notes / watercolor / fantasy-animation / nature | Wrong temperament — those are warm |+| ✗ tech-neon / digital-dashboard | Mono-ink is intentionally non-digital |+| ✗ corporate-photo | Photography can't be mono-ink |+| ✗ chalkboard | Mono-ink is white-paper-black-ink; chalkboard is opposite |++## Fewshot prompt snippets++**Snippet A — applied to an ink-notes Before/After comparison**++> [...rendering paragraph...] Color behavior is mono-ink with semantic accents: pure white background `#FFFFFF` (about 55%); all line work, figures, and hand-lettered text in near-black ink `#1A1A1A` (about 38%). Left "Before" side carries coral red accent `#E8655A` on its pain-point markers only (about 4% of total canvas). Right "After" side carries muted teal `#5FA8A8` on solution markers only (about 3%). Total color accent stays under 8%. Deck's primary `#1E3A5F` and secondary `#F8F9FA` are intentionally not used here — mono-ink's discipline is the visual point. [...container guidance...]++**Snippet B — applied to an ink-notes framework diagram**++> [...rendering paragraph...] Color behavior is mono-ink: pure white background `#FFFFFF` (about 58%); central frame, sub-components, connector arrows, and stick-figure labels in near-black ink `#1A1A1A` (about 38%). The deck's accent `#D4AF37` appears only as a single thin emphasis ring around the central frame — about 4% of canvas. No other color. The deck's primary and secondary are not represented as image colors in this manifesto-style palette. [...container guidance...]++## What to avoid++- Adding the deck's primary or secondary as image colors (defeats mono-ink discipline)+- Color accent exceeding 10% of canvas+- More than 2 semantic accent colors+- Cream or warm paper (that's `sketch-notes` / `warm-earth`, not mono-ink)+- Saturated digital feeling (mono-ink is paper-and-ink)++## When to switch away++- For warm educational feel → `macaron` palette + `sketch-notes` rendering+- For broader color use → any other palette+- For digital aesthetic → `cool-corporate` or `tech-neon`diff --git a/skills/ppt-master/references/image-palettes/nature-organic.md b/skills/ppt-master/references/image-palettes/nature-organic.mdnew file mode 100644index 00000000..866d1f9d--- /dev/null+++ b/skills/ppt-master/references/image-palettes/nature-organic.md@@ -0,0 +1,70 @@+# Palette: nature-organic++Earthy, natural, wellness. The palette for environment / sustainability / wellness / outdoor / food / agriculture decks. Distinguished by **earth-toned warm and cool greens**, with cream and earth-brown backgrounds.++> This file describes **color behavior**, not HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Mid — earth tones are rich but slightly desaturated |+| Brightness contrast | Soft — earth tones layer comfortably |+| Color count visible | 3-4 |+| Mood | Grounded, natural, sustainable, contemplative |+| Material | Soft natural textures permitted |++## Proportion rule (50-35-15, earthy)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / natural field | **45-55%** | `secondary` | Cream, soft warm beige, or pale sage. The "outdoor breath" of the image. |+| Primary natural color | **30-40%** | `primary` | Deep forest green, deep earth brown, warm terracotta. Dominant natural element. |+| Accent natural pop | **10-15%** | `accent` | A small natural pop — golden honey, soft coral, deep autumn red. Often used as a fruit, flower, or warm detail. |++## Role semantics++- **Primary** is the natural anchor — the dominant earth color (greens for forest/wellness, browns/terracottas for earth/agriculture).+- **Secondary** is the natural breath — soft cream or sage carrying outdoor warmth.+- **Accent** is a small natural detail — never artificial-bright, always feels found-in-nature.++## How to phrase it in a prompt++> "Color behavior is nature-organic: secondary soft cream `#FEF3C7` covers the background field as gentle outdoor breath (about 50%). Primary deep forest green `#166534` carries the dominant natural forms — foliage, hills, organic shapes (about 35%). Accent warm honey `#D4AF37` appears in small natural detail pops — a flower, a fruit, a sunlit highlight (about 13%). All tones feel earthy and slightly desaturated, like a sustainable wellness palette."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ nature | Direct alignment |+| ✓✓ watercolor | Natural washes |+| ✓✓ warm-scene | Outdoor warm cinematic |+| ✓✓ fantasy-animation | Storybook nature |+| ✓✓ sketch-notes | Educational nature content |+| ✓✓ corporate-photo | Outdoor / wellness photography |+| ✓ vector-illustration | Natural vector |+| ✗ tech-neon / dark-cinematic / digital-dashboard / blueprint | Wrong temperament |+| ✗ pixel-art | Earth feel doesn't fit pixel grid |++## Fewshot prompt snippets++**Snippet A — applied to a nature illustration**++> [...rendering paragraph...] Color behavior is nature-organic: soft cream background `#FEF3C7` (about 50%); primary deep forest green `#166534` in stylized leaves and a central tree silhouette (about 35%); accent warm honey-amber `#D4AF37` in small detail pops — a few hand-drawn flowers at the base, sunlit highlights on leaf tips (about 13%). Earth-toned and slightly desaturated. [...container guidance...]++**Snippet B — applied to a corporate-photo wellness scene**++> [...rendering paragraph...] Color behavior is nature-organic photography: image is graded toward soft outdoor warmth. Cream `#FEF3C7` highlights in the sky/background (about 50%). Primary forest green `#166534` in foliage and natural elements (about 33%). Accent warm honey `#D97706` in golden hour light hitting key surfaces (about 14%). All tones earthy, slightly desaturated, wellness-quality. [...container guidance...]++## What to avoid++- Artificial / neon greens (defeats natural earth feel)+- Sterile / clinical backgrounds (nature wants warmth)+- Industrial / tech subjects (wrong palette family)+- Too-saturated accents++## When to switch away++- For corporate / consulting → `cool-corporate`+- For broader warm storytelling → `warm-earth`+- For tech / SaaS → `tech-neon`diff --git a/skills/ppt-master/references/image-palettes/tech-neon.md b/skills/ppt-master/references/image-palettes/tech-neon.mdnew file mode 100644index 00000000..d2622932--- /dev/null+++ b/skills/ppt-master/references/image-palettes/tech-neon.md@@ -0,0 +1,71 @@+# Palette: tech-neon++Energetic, futuristic, high-contrast. The signature look for AI / SaaS / product launch / cyber / cutting-edge tech decks. Distinguished by saturated brand color on a darker or contrasted field, with a glow / luminance quality.++> This file describes **color behavior**, not HEX values. HEX comes from `design_spec.colors`.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | High — colors are intentionally vivid |+| Brightness contrast | Strong — vivid foreground on darker or neutral background |+| Color count visible | 3 (primary + secondary + accent) — restraint despite vividness |+| Mood | Energetic, futuristic, confident, edge |+| Material | Smooth digital, often with implied glow or luminance |++## Proportion rule (50-35-15, with intentional luminance)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / digital field | **45-55%** | `secondary` | Either a near-white digital field (light mode tech) OR a deep dark field like `#0A0E27` (dark mode tech). The choice depends on deck's overall mood. |+| Main subject / vivid brand | **30-40%** | `primary` | The saturated brand color — electric blue, vibrant teal, neon green. Renders confidently against the background. |+| Emphasis / accent glow | **10-15%** | `accent` | The "this is the future" pop — neon cyan, hot magenta, bright orange. Often rendered with implied glow / soft halo. |++> tech-neon is the rendering palette most likely to suggest **glow or luminance** in the prompt — primary forms often have a soft outer glow at 8% opacity in the same color.++## Role semantics++- **Primary** is the brand signature — vivid, confident, the visual lead. Use it for: dominant chart elements, hero shape fills, primary geometric forms.+- **Secondary** sets the technological tone — clean digital surface or deep digital void. Should feel "screen-like" or "interface-like".+- **Accent** is the future-pop — small, glowing, attention-grabbing. Often rendered with implied luminance.++## How to phrase it in a prompt++> "Color behavior is tech-neon: secondary deep digital navy `#0A0E27` covers about 50% of the canvas as the dark field; primary electric blue `#0EA5E9` carries the main subject in confident saturated tones (about 35%) with a soft 8%-opacity glow halo around it; accent vivid cyan `#06B6D4` appears in 10-15% as small bright pops, also with implied glow. High contrast between vivid foreground and dark digital background."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ 3d-isometric | Tech architecture with glowing edges |+| ✓✓ digital-dashboard | Product UI with neon highlights |+| ✓✓ flat | Bold flat blocks with neon accent |+| ✓ vector-illustration | Works but feels more muted than expected |+| ✓✓ blueprint | Technical schematic with luminance |+| ✓ pixel-art | Retro neon gaming |+| ✗ sketch-notes / watercolor / fantasy-animation / nature | Temperament conflict — warm vs cyber |+| ✗ corporate-photo | Photography wants natural color, not neon |++## Fewshot prompt snippets++**Snippet A — applied to a 3d-isometric architecture**++> [...rendering paragraph...] Color behavior is tech-neon: secondary deep navy `#0A0E27` covers the background plane and shadowed faces (about 50% of canvas); primary electric blue `#0EA5E9` carries the lit faces of the stacked blocks in saturated solid fills (about 35%) with a subtle 8%-opacity outer glow around each block's edge; accent vivid cyan `#06B6D4` appears on connecting lines and one highlighted block's lit face (about 12% area total) with stronger implied glow. High contrast throughout. [...container guidance...]++**Snippet B — applied to a digital-dashboard demo**++> [...rendering paragraph...] Color behavior is tech-neon dashboard: secondary near-white digital `#F8FAFC` covers the surface field (about 55%); primary electric blue `#0EA5E9` in the dominant chart bars, vivid and saturated, with subtle 8%-opacity glow at the bar tops (about 32%); accent neon coral `#F97316` reserved for one highlighted KPI tile — the focal data point — at about 13%, with luminance halo. The overall feel is energetic, brand-forward, future-product. [...container guidance...]++## What to avoid++- Muted / desaturated colors (defeats tech-neon's vividness)+- Warm earth tones in the same image (mood conflict)+- Heavy textures (tech-neon is smooth-digital, not painterly)+- More than 3 distinct vivid colors (becomes carnival)++## When to switch away++- For restrained / professional decks → `cool-corporate`+- For warm / human decks → `warm-earth`+- For premium / cinematic dark → `dark-cinematic`diff --git a/skills/ppt-master/references/image-palettes/vivid-launch.md b/skills/ppt-master/references/image-palettes/vivid-launch.mdnew file mode 100644index 00000000..0f79a63f--- /dev/null+++ b/skills/ppt-master/references/image-palettes/vivid-launch.md@@ -0,0 +1,72 @@+# Palette: vivid-launch++Bold, saturated, attention-grabbing. The palette for product launches, marketing campaigns, event keynotes, promotional decks. Distinguished from tech-neon by **richer warm-cool balance** and more confident multi-color presence.++> This file describes **color behavior**, not HEX values.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | High — colors are intentionally vivid |+| Brightness contrast | Strong — vivid colors against bright field |+| Color count visible | 3-4 |+| Mood | Energetic, confident, promotional, attention-first |+| Material | Flat saturated fills |++## Proportion rule (40-35-25, vivid-balanced)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Bright field / background | **35-45%** | `secondary` | Often near-white, bright cream, or a saturated brand color used as background. |+| Primary brand vivid | **30-40%** | `primary` | The vivid lead — saturated brand color in confident solid blocks. |+| Accent vivid pop | **20-30%** | `accent` | More generous than other palettes — accent is a co-star, not a small detail. Can take 20-25% of canvas. |++> vivid-launch is the **most accent-generous** palette — promotional context tolerates strong color presence.++## Role semantics++- **Primary** is the brand lead — the vivid signature of the launch.+- **Secondary** is the bright supporting field — should feel "open" and "celebrate".+- **Accent** is the co-star — bold, generous, attention-grabbing. Can take much more area than other palettes' accents.++## How to phrase it in a prompt++> "Color behavior is vivid-launch: secondary near-white `#FAFAFA` (about 40%) carries the bright field; primary saturated brand magenta `#E11D48` carries dominant shapes in confident vivid blocks (about 35%); accent vivid orange `#F97316` is a co-star color appearing in 25% of the canvas as a major secondary subject. All colors are intentionally saturated and bold. Promotional, attention-grabbing temperament."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ flat | Vivid flat blocks for marketing |+| ✓✓ vector-illustration | Bold vector launch visuals |+| ✓✓ 3d-isometric | Vivid product 3D |+| ✓✓ screen-print | Vivid promotional poster |+| ✓✓ pixel-art | Retro vivid gaming launch |+| ✓ digital-dashboard | Acceptable if launch product is software |+| ✓ corporate-photo | Vivid-graded photography |+| ✗ sketch-notes / ink-notes / nature | Wrong temperament — those are restrained |+| ✗ watercolor / warm-scene | Wrong saturation level |++## Fewshot prompt snippets++**Snippet A — applied to a flat marketing hero**++> [...rendering paragraph...] Color behavior is vivid-launch: secondary near-white `#FAFAFA` background (about 38%); primary saturated brand magenta `#E11D48` carries the dominant central shape — a bold geometric burst (about 35%); accent vivid orange `#F97316` is co-star — a large supporting block or burst in the upper right (about 25%). One small detail in deep neutral `#171717` for definition (about 2%). All colors confident and saturated. Promotional energy. [...container guidance...]++**Snippet B — applied to a 3d-isometric product launch**++> [...rendering paragraph...] Color behavior is vivid-launch: secondary bright cream `#FEF3C7` background plane (about 35%); primary vivid teal `#0F766E` on the main product block's lit faces (about 38%, with darker teal shaded faces); accent vivid coral `#F97316` on a secondary product block — a co-star not a small detail (about 25%). Bold, confident, promotional. Soft 8% drop shadows for depth. [...container guidance...]++## What to avoid++- Pastel / muted colors (defeats the vividness)+- Restrained accent (vivid-launch wants accent as co-star)+- More than 4 distinct vivid colors (becomes carnival rather than launch)++## When to switch away++- For restrained corporate → `cool-corporate`+- For warm story → `warm-earth`+- For premium dark → `dark-cinematic`+- For technical brand → `tech-neon`diff --git a/skills/ppt-master/references/image-palettes/warm-earth.md b/skills/ppt-master/references/image-palettes/warm-earth.mdnew file mode 100644index 00000000..61dab479--- /dev/null+++ b/skills/ppt-master/references/image-palettes/warm-earth.md@@ -0,0 +1,75 @@+# Palette: warm-earth++Friendly, grounded, human. The warm counterpart to cool-corporate — used in brand storytelling, lifestyle, education, wellness, and any deck where human warmth matters more than corporate restraint.++> This file describes **color behavior**, not HEX values. HEX comes from `design_spec.colors`.++## Temperament++| Trait | Setting |+|---|---|+| Saturation | Medium — warm tones feel rich but not vivid |+| Brightness contrast | Moderate — warm earth tones layer well without harsh contrast |+| Color count visible | 3-4 (primary + secondary + accent + optional warm neutral) |+| Mood | Friendly, grounded, approachable, slightly nostalgic |+| Material | Soft — leaves room for texture (paper grain, watercolor wash) |++## Proportion rule (50-35-15, applied to the deck's HEX)++| Role | Share | HEX from `design_spec` | Behavior |+|---|---|---|---|+| Background / supporting field | **50-60%** | `secondary` | Warm cream, soft beige, gentle off-white. Carries breathing space with warmth. |+| Main subject / dominant warm element | **30-40%** | `primary` | The earthy warm tone — terracotta, deep amber, warm rust, deep olive. The visual anchor. |+| Emphasis / warm pop | **10-15%** | `accent` | A small concentrated warm pop (golden yellow, coral, deep red). More generous than cool-corporate's 5-7%, because warm palettes tolerate more saturation visually. |++> warm-earth is more permissive than cool-corporate about color presence — warm tones layer comfortably without feeling promotional.++## Role semantics++- **Primary** carries grounding warmth, the human anchor. Use it for: dominant warm forms, foreground subjects, body of illustration, main subject silhouette.+- **Secondary** is the warm breathing field. Use it for: soft cream background, paper field, atmospheric haze. Should feel cozy, not sterile.+- **Accent** carries small warm pops of energy. Use it for: the standout flower, the warm sunlight glow, the highlighted detail. Allowed to be slightly more visible than cool-corporate's accent.++## How to phrase it in a prompt++> "Color behavior is warm-grounded: secondary `#FEF3C7` (warm cream) carries about 55% of the canvas as soft breathing space; primary `#9A3412` (deep terracotta) anchors the main forms in confident warm tones occupying about 32%; accent `#D4AF37` (warm gold) appears in small concentrated pops totaling under 13% — perhaps as a glow, a flower, a sunlight detail. Soft warm temperament throughout, no cool tones."++## Compatible renderings++| Rendering | Notes |+|---|---|+| ✓✓ vector-illustration | Warm vector forms work well |+| ✓✓ flat | Warm flat blocks are friendly |+| ✓✓ sketch-notes | Natural pairing — both warm-earth and sketch-notes share warmth |+| ✓✓ watercolor | Warm washes pair perfectly |+| ✓✓ warm-scene | Direct alignment |+| ✓✓ fantasy-animation | Storybook warmth |+| ✓✓ nature | Earth-tone alignment |+| ✓✓ corporate-photo | Warm-graded photography |+| ✓ editorial | Acceptable — editorial restraint sometimes prefers cool |+| ✗ tech-neon themes / dark-cinematic | Temperament conflict |+| ✗ blueprint | Blueprint wants restraint; warm-earth wants warmth |++## Fewshot prompt snippets++**Snippet A — applied to a watercolor narrative scene**++> [...rendering paragraph...] Color behavior is warm-grounded: secondary cream `#FEF3C7` occupies the upper third as soft sky and breathing space (about 50% of canvas); primary deep terracotta `#9A3412` carries the midground hills and foreground earth in confident warm washes (about 35%); accent warm gold `#D4AF37` appears as a small concentrated glow near the horizon and a single golden bird shape in the foreground (totaling under 15%). All tones warm, no cool blues or greens beyond a barely-perceptible suggestion in the sky. [...container guidance...]++**Snippet B — applied to a sketch-notes educational block**++> [...rendering paragraph...] Color behavior is warm-grounded: cream paper background `#FEF3C7` carries about 55% of the area. Primary deep amber `#B45309` fills the rounded info boxes in a soft pastel tint (about 35% area). Accent warm coral `#F97316` appears on one highlighted arrow and a few small doodle decorations (totaling 10-13%). All hand-drawn ink in near-black. No cool tones. [...container guidance...]++## What to avoid++- Cool color mixing (a stray blue / teal breaks the warm identity)+- Over-saturated accent (warm-earth's accent is warm-rich, not neon-loud)+- Sterile / clinical feel (defeats the warmth — switch to cool-corporate)+- Equal-share triplet (creates a flag-like balance instead of warm-grounded depth)++## When to switch away++- For corporate / consulting → `cool-corporate`+- For premium / cinematic → `dark-cinematic`+- For methodology / sharp manifesto → `mono-ink`+- For event / launch / saturated bold → `vivid-launch`diff --git a/skills/ppt-master/references/image-renderings/3d-isometric.md b/skills/ppt-master/references/image-renderings/3d-isometric.mdnew file mode 100644index 00000000..ce8b4e45--- /dev/null+++ b/skills/ppt-master/references/image-renderings/3d-isometric.md@@ -0,0 +1,56 @@+# Rendering: 3d-isometric++Isometric 3D forms with controlled depth — boxes, layers, devices, stacks rendered in 30°/30°/30° projection. The dominant choice for tech architecture, product structure, and system composition visuals in modern decks.++## Style paragraph (paste-ready, 105 words)++> 3D isometric illustration with clean geometric forms rendered in true 30°/30°/30° projection. All edges are crisp and uniform — no perspective distortion, no vanishing points. Surfaces use flat solid fills with subtle tonal shifts (a single darker shade for shadowed faces, ~15% darker than the light-facing face) to convey volume without painterly rendering. Edges may have thin uniform outlines or use direct color contrast. Composition emphasizes stackable, modular forms — boxes, blocks, layers, cards floating in arrangement. Soft 8% drop shadows beneath floating elements anchor them in space. Overall feel is technical, structured, contemporary — common in SaaS product diagrams, cloud architecture visuals, system component breakdowns.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Thin uniform edges, or no edges relying on color contrast |+| Texture | None on surfaces — flat fills |+| Depth | True isometric projection (30°/30°/30°), tonal shading on shadowed faces, optional 8% drop shadow under floating elements |+| Material | Flat with tonal shading — not glossy, not photorealistic |+| Mood | Technical, modular, contemporary |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page architecture visual | 600×500 | ~1.2 | 15% |+| Hero technical diagram | 1200×500 | 2.4:1 | 12% |+| Square component breakdown | 700×700 | 1:1 | 15% |+| Spot illustration | 400×400 | 1:1 | 12% |++## Using the deck's HEX values++- Primary HEX: main block face fills (the "lit" face)+- Secondary HEX: background field+- Accent HEX: a single highlighted block or connecting line+- Shadowed faces: ~15% darker shade of the primary (automatic from prompt phrasing — no extra HEX needed)++## Fewshot prompt snippets++**Snippet A — half-page system architecture, text_policy: none**++> 3D isometric illustration in true 30°/30°/30° projection. Three stacked blocks rise from a clean isometric plane — a wide foundation block in primary deep blue `#1E40AF`, a medium block in slightly darker blue stacked on top, and a smaller block on top of that. To the right, two floating cards in the same blue family hover above the stack, connected by thin diagonal lines. The "lit" faces of all blocks use the primary blue; the shadowed faces use a 15% darker tonal shift of the same blue. Accent gold `#D4AF37` appears as one thin line connecting the top block to a floating card. Background is calm secondary `#F8FAFC`. Soft 8% drop shadows beneath the floating cards. Composed as a 600×500 half-page block with 15% inner padding. NO text, no labels, no numbers anywhere in the image. Color values are rendering guidance only.++**Snippet B — hero technical banner, text_policy: none**++> 3D isometric illustration banner showing a modular cloud architecture. Five rounded-edge cards arranged in a horizontal flow across the canvas, each card a distinct 3D volume in true 30°/30°/30° projection. Cards alternate in primary teal `#0F766E` and a 15% darker tonal shade for shadowed faces. Thin connecting lines in accent orange `#F97316` indicate dataflow between cards. Background plane in soft secondary `#F1F5F9`. Soft 8% drop shadows ground each card. Each card contains a single simple iconic symbol on its top face — a database cylinder, a gear, an upward arrow, a cloud silhouette, a lock — rendered in white. Composed for a 1200×500 hero band with 12% inner padding. NO text, letters, numbers anywhere. Color values are rendering guidance only.++## What to avoid++- True perspective (1-point or 2-point) — isometric is parallel projection by definition+- Realistic lighting / specular highlights — keep it flat-shaded+- More than 5-6 distinct objects in one image — isometric loses clarity with clutter+- Mixed projection angles in the same image++## When to switch away++- For utility illustrations without depth → `vector-illustration`+- For dashboards / UI surfaces → `digital-dashboard`+- For abstract schematics rather than 3D forms → `blueprint`diff --git a/skills/ppt-master/references/image-renderings/_index.md b/skills/ppt-master/references/image-renderings/_index.mdnew file mode 100644index 00000000..e3607c5a--- /dev/null+++ b/skills/ppt-master/references/image-renderings/_index.md@@ -0,0 +1,80 @@+# Renderings — Index++A **rendering** is a visual style family: line quality, texture, depth, material, mood. Lock one rendering per deck — every AI image in the deck shares it.++> **HEX values are not in renderings**. The deck's HEX triplet comes from `design_spec.colors`. Rendering describes *how* the image is drawn; palette describes *how* the HEX values are distributed. See [`image-generator.md`](../image-generator.md) §1.++## Catalog (16 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.++### Modern / commercial (the corporate-PPT main field)++| Rendering | One-liner | Best for |+|---|---|---|+| [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 |+| [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 |+| [blueprint](blueprint.md) | Technical schematic with grid, monospace cues | Architecture / engineering / AI systems |+| [editorial](editorial.md) | Magazine-style infographic look | Finance / journalism / explainers |++### Hand-drawn / educational++| Rendering | One-liner | Best for |+|---|---|---|+| [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 |++### Narrative / atmospheric++| Rendering | One-liner | Best for |+|---|---|---|+| [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 |++### Specialty++| Rendering | One-liner | Best for |+|---|---|---|+| [fantasy-animation](fantasy-animation.md) | Ghibli/Disney hand-drawn warmth | Children / storybook / brand fable |+| [pixel-art](pixel-art.md) | 8-bit retro game aesthetic | Gaming / retro tech / nostalgic |+| [nature](nature.md) | Organic earthy illustration | Environment / wellness / sustainability |++---++## Auto-selection table — `design_spec` → rendering++Match `design_spec.md d. Style` (mode + descriptor) against this table. First match wins. If no row matches, default to `vector-illustration`.++| `d. Style` signal | Recommended rendering | Alternates |+|---|---|---|+| Top Consulting / strategic / MBB | `editorial` or `vector-illustration` | `blueprint` |+| General Consulting / corporate report | `vector-illustration` | `flat`, `digital-dashboard` |+| Tech / SaaS / AI / system / architecture | `3d-isometric`, `blueprint`, or `digital-dashboard` | `flat`, `vector-illustration` |+| Product launch / brand / marketing | `flat`, `3d-isometric`, or `corporate-photo` | `vector-illustration` |+| Education / training / onboarding / 教学 | `sketch-notes` | `vector-illustration` (if school is corporate) |+| 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` |+| Classroom / blackboard / 课堂 | `chalkboard` | `sketch-notes` |+| Team / company / product photo | `corporate-photo` | — |++> **Tiebreaker**: when both `vector-illustration` and another rendering apply, prefer `vector-illustration` for slide decks of 15+ pages (it scales visual coherence better than more decorative renderings).++## How to use++1. From `design_spec.md` extract `d. Style` mode + descriptor.+2. Find the matching row above; pick the primary recommendation.+3. `read_file image-renderings/<chosen>.md`.+4. Apply its style paragraph and container guidance when assembling each prompt per `image-generator.md` §1.2.++**Lock for the whole deck.** Don't change rendering between images in the same deck.diff --git a/skills/ppt-master/references/image-renderings/blueprint.md b/skills/ppt-master/references/image-renderings/blueprint.mdnew file mode 100644index 00000000..86be682f--- /dev/null+++ b/skills/ppt-master/references/image-renderings/blueprint.md@@ -0,0 +1,56 @@+# Rendering: blueprint++Technical schematic aesthetic — clean lines on a grid, monospace cues, restrained color. Conveys engineering precision and analytical depth. Used for architecture diagrams, AI systems, engineering decks, technical deep-dives.++## Style paragraph (paste-ready, 95 words)++> Technical blueprint schematic style. Clean precise lines on an implied or subtle grid, with deliberate geometric rigor — right angles, parallel rules, measured spacing. Elements are simplified to essential schematic forms — boxes, rounded rectangles, connector lines, anchor dots, callout markers. Color is restrained, often near-monochrome with one or two semantic accents (one color for "primary path", one for "alternate" or "warning"). Optional subtle grid background at very low opacity (5-8%) reinforces the schematic feel. No textures, no shading, no painterly artifacts. Overall feel is engineering-precise, analytical, intentional — common in system design and architecture briefings.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Crisp uniform stroke, often 1-1.5px feel; perfectly straight or precisely curved |+| Texture | None; optional very-low-opacity grid background |+| Depth | Flat — schematic, not perspectival |+| Material | None — abstract schematic |+| Mood | Analytical, engineering-precise, restrained |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page architecture | 600×500 | ~1.2 | 12-15% |+| Hero system diagram | 1200×500 | 2.4:1 | 12% |+| Square component | 700×700 | 1:1 | 15% |+| Spot schematic | 400×400 | 1:1 | 12% |++## Using the deck's HEX values++- Primary HEX: main schematic lines and primary boxes+- Secondary HEX: background (often near-white, or very pale blue if a blueprint mood is wanted)+- Accent HEX: highlighted path / warning / focus element+- Optional grid: secondary HEX at 5-8% opacity++## Fewshot prompt snippets++**Snippet A — half-page system architecture, text_policy: none**++> Technical blueprint schematic. Six rounded rectangles arranged in a clean two-row layout, connected by precise straight lines with small arrow heads. All rectangles use crisp 1.5px uniform stroke in primary deep blue `#1E40AF` on a near-white secondary background `#FAFAFA`. A subtle grid pattern in primary blue at 6% opacity provides a schematic feel. One rectangle is highlighted by replacing its stroke with accent orange `#F97316` — the focus component. Each rectangle contains a single simple iconic symbol — a database cylinder, a gear, a chat bubble, an upward arrow, a lock, a network node — rendered in the same primary blue, no fill. Connector lines route at right angles, with small dot anchors at junctions. Composed as a 600×500 half-page block with 14% inner padding. NO text, no labels, no numbers — pure schematic structure. Color values are rendering guidance only.++**Snippet B — hero pipeline diagram, text_policy: none**++> Technical blueprint pipeline schematic, banner format. Five rounded rectangle stages arranged horizontally across the canvas, connected by precise arrow-headed lines. All stages use 1.5px primary teal `#0F766E` stroke on a near-white background `#FAFAFA`. The third stage (center) is rendered with accent gold `#D4AF37` stroke as the focal stage. A subtle 6%-opacity grid background reinforces the schematic feel. Small anchor dots at every line junction. Each stage contains one iconic symbol — input arrow, gear, magnifier, transform symbol, output arrow — in monoline schematic style. Composed for a 1200×500 hero band with 12% inner padding. NO text or labels anywhere. Color values are rendering guidance only.++## What to avoid++- Realistic textures or materials+- Decorative flourishes — blueprint is intentionally austere+- More than 2 accent colors — restraint is the aesthetic+- Cluttered diagrams (>8 components)++## When to switch away++- For 3D depth on technical visuals → `3d-isometric`+- For product UI / dashboard surfaces → `digital-dashboard`+- For brand-aware design rather than technical schematic → `flat` or `vector-illustration`diff --git a/skills/ppt-master/references/image-renderings/chalkboard.md b/skills/ppt-master/references/image-renderings/chalkboard.mdnew file mode 100644index 00000000..7a5151bf--- /dev/null+++ b/skills/ppt-master/references/image-renderings/chalkboard.md@@ -0,0 +1,56 @@+# Rendering: chalkboard++Chalk on a dark green or black board — classroom aesthetic. Used in teaching-focused decks, tutorials, school / academic content, retro educational atmosphere.++## Style paragraph (paste-ready, 95 words)++> Classroom chalkboard aesthetic. Dark green or near-black slate background with visible subtle chalk-dust texture. All marks appear as soft chalk strokes — slightly diffused edges, off-white or pastel colors that look powdery rather than saturated. Hand-drawn lines are confident but with the characteristic dry-medium quality of real chalk. Composition follows blackboard pedagogy — central or organized layout, clear sections, occasional underlines and emphasis marks. Color is restrained: white chalk dominates, one or two pastel accents (yellow, soft pink, light cyan) appear sparingly. Overall feel is nostalgic, instructional, warm-classroom — common in teaching content and tutorial decks.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Soft chalk strokes with slightly diffused edges, dry-medium look |+| Texture | Visible chalk-dust grain at 15-25% opacity across the board |+| Depth | Flat |+| Material | Slate board (dark green or near-black) + chalk |+| Mood | Nostalgic, instructional, classroom-warm |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page lesson block | 600×500 | ~1.2 | 14% |+| Hero teaching banner | 1200×500 | 2.4:1 | 14% |+| Square lesson visual | 700×700 | 1:1 | 14% |++## Using the deck's HEX values++chalkboard has a strong **fixed-palette tendency**: dark slate background + white chalk + pastel accents.++- Background: dark slate green `#1F3A2E` or near-black `#1A1A1A` (does not use the deck's secondary)+- Primary chalk: off-white `#F5F5F0` (the chalk itself); the deck's primary HEX may appear as a tinted pastel accent+- Accent: the deck's accent HEX rendered as a soft pastel chalk shade++## Fewshot prompt snippets++**Snippet A — half-page lesson visual, text_policy: embedded**++> Classroom chalkboard aesthetic. Dark slate green background `#1F3A2E` with visible chalk-dust texture at 20% opacity. Three rounded boxes drawn in soft white chalk strokes arranged in a row, each containing a simple chalk-drawn icon (a tree, a lightbulb, a paper plane). Above the boxes, a hand-lettered chalk title in confident white lettering reads "GROWTH" in English block caps. Hand-drawn chalk arrows connect the boxes left-to-right. Small chalk star and dot decorations sprinkled sparingly. One soft pastel-yellow chalk underline below the title, drawn with deliberate dry-medium quality. Composed as a 600×500 half-page block with 14% inner padding. NO Chinese characters — chalk text in short English only. Color values are rendering guidance only.++**Snippet B — hero classroom banner, text_policy: none**++> Classroom chalkboard hero banner. Dark slate near-black background `#1A1A1A` with subtle chalk-dust texture. Five circular chalk-drawn nodes arranged horizontally connected by chalk-drawn arrows. Each node contains a chalk-drawn iconic symbol — a seed, a sprout, a young plant, a tree, a forest — telling a sequence visually. All chalk strokes appear soft and dry, with characteristic diffused edges. A single accent of soft pastel coral chalk highlights the third node's outline. Composed for a 1200×500 hero band with 14% inner padding. NO text, letters, numbers, or labels. Color values are rendering guidance only.++## What to avoid++- Sharp digital-feeling edges (chalk should feel soft and dry)+- Saturated colors (chalk accents are pastel, not vivid)+- Mixed media (chalk + watercolor, chalk + ink) — pure chalkboard only+- Modern UI elements (no rounded-corner cards; chalkboard is freehand)++## When to switch away++- For corporate / consulting decks → `vector-illustration` or `editorial`+- For warm-cream paper instead of dark board → `sketch-notes`+- For pure white + ink → `ink-notes`diff --git a/skills/ppt-master/references/image-renderings/corporate-photo.md b/skills/ppt-master/references/image-renderings/corporate-photo.mdnew file mode 100644index 00000000..d93de3be--- /dev/null+++ b/skills/ppt-master/references/image-renderings/corporate-photo.md@@ -0,0 +1,67 @@+# Rendering: corporate-photo++Editorial photography style — real subjects, natural composition, professional grading. The only rendering where photorealism is intentional. Used for team photos, lifestyle shots, product photography, real-world scenarios.++## Style paragraph (paste-ready, 100 words)++> Editorial photography style with natural composition and professional color grading. Subjects appear as real people, real products, real environments — captured with depth-of-field and intentional lighting. Composition follows photographic principles: rule of thirds, leading lines, deliberate foreground/background separation. Lighting is natural or studio-soft, never harsh. Color grading matches the deck's palette temperament — corporate decks lean cool and restrained, lifestyle decks lean warm and golden. Subjects in team or workplace contexts appear diverse and professionally attired. Background is contextual and slightly blurred to keep focus on the subject. Overall feel is authentic, premium, magazine-quality.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | N/A — photographic |+| Texture | Natural — skin, fabric, environment textures preserved |+| Depth | True depth-of-field — subject sharp, background subtly blurred |+| Material | Real-world physical materials, professionally lit |+| Mood | Authentic, premium, magazine-editorial |++## ⚠️ Exception to global hard rule §3.2++corporate-photo **overrides** the global "simplified silhouettes / no realistic faces" rule (image-generator.md §3.2). For this rendering, append instead:++> Diverse, professionally attired subjects rendered photorealistically. Editorial photography composition, natural light or soft studio lighting. Subjects appear authentic and contemporary — no posed stock-photo stiffness, no exaggerated expressions, no fashion-shoot artificiality.++All other renderings keep the simplified-figure rule.++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page lifestyle shot | 600×800 | 3:4 | 8% (photography fills the frame more) |+| Hero team photo | 1200×600 | 2:1 | 8% |+| Spot portrait | 400×500 | 4:5 | 8% |+| Full-bleed product hero | 1280×720 | 16:9 | 8% |++## Using the deck's HEX values++corporate-photo's relationship to HEX is **color grading**, not color fills:++- Primary HEX: dominant tone the image is graded toward (cool grade for navy primary, warm grade for terracotta primary)+- Secondary HEX: highlight tone in the lit areas+- Accent HEX: a subtle environment color (a sweater, a wall accent, a product detail) that picks up the deck's accent+- HEX values appear as **color cues** in the description, not as literal HEX strings in the image++## Fewshot prompt snippets++**Snippet A — team workplace photo, text_policy: none**++> Editorial photography of a small modern team collaborating around a laptop in a contemporary office. Three to four diverse, professionally attired adults — varied ethnicities, varied ages — engaged in genuine conversation, no posed stock-photo stiffness. Natural window light from the side, soft shadows. Color grading is cool-corporate — image is subtly graded toward deep blue tones echoing the deck's primary `#1E3A5F`, with the background carrying soft light gray `#F8F9FA` walls and a single accent of warm wood or amber from a desk lamp echoing the accent `#D4AF37`. Shallow depth of field — subjects sharp, background gently blurred. Composed as a 1200×600 hero band with 8% inner padding. Diverse, professionally attired subjects rendered photorealistically. Editorial photography composition. Authentic, not stock-photo artificial. Color values are rendering guidance — HEX codes themselves do not appear in the image as text.++**Snippet B — product lifestyle photo, text_policy: none**++> Editorial product photography of a sleek consumer device on a contemporary desk. Soft natural light from the upper left, gentle shadow cast to the lower right. Wood desk surface in warm beige tones, with a notebook and a cup of coffee in supporting context — slightly out of focus to keep attention on the device. Color grading is warm-editorial — image leans toward soft amber and cream, with the device itself catching a subtle highlight of accent terracotta `#C2410C`. Background wall in calm secondary cream `#FEF3C7`, gently blurred. Shallow depth of field. Composed as a 600×800 half-page block with 8% inner padding. Photorealistic, magazine-editorial quality. Color values are rendering guidance only.++## What to avoid++- Stock-photo stiffness (forced smiles, frozen handshakes, fake-laughing meetings)+- Fashion-shoot artificiality (over-styled, over-lit, model-pose)+- Specific celebrity / public figure likenesses+- Visible brand logos on products unless explicitly intended+- Overly homogeneous casting (all same age, ethnicity, gender)++## When to switch away++- For abstract / concept work → `vector-illustration`, `flat`, or `3d-isometric`+- For atmospheric narrative scenes (not photography) → `warm-scene` or `watercolor`+- For technical / system visuals → `blueprint` or `3d-isometric`diff --git a/skills/ppt-master/references/image-renderings/digital-dashboard.md b/skills/ppt-master/references/image-renderings/digital-dashboard.mdnew file mode 100644index 00000000..d3f95bd4--- /dev/null+++ b/skills/ppt-master/references/image-renderings/digital-dashboard.md@@ -0,0 +1,56 @@+# Rendering: digital-dashboard++Polished UI / data-visualization aesthetic. The image looks like a screenshot of a product or analytics dashboard — clean cards, soft shadows, restrained type, chart-like visual elements. Used in SaaS demos, data product showcases, B2B analytics decks.++## Style paragraph (paste-ready, 105 words)++> Polished digital UI / dashboard aesthetic. Clean card-based layout with rounded corners (8-12px radius), uniform soft shadows (8% opacity, slight Y-offset), and crisp pixel-aligned edges. Surfaces are flat with restrained color — primarily one neutral background, several brand-color cards or chart elements, and a single accent for the focal data point. Chart-like visual elements (bar graphs, line graphs, sparklines, donut segments, KPI tiles) appear stylized — recognizable as charts but without specific data values. Typography would be small, neutral, almost-text-as-texture if any appeared, but defaults to no-text. Overall feel is product-screenshot — modern, restrained, data-fluent.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | No outlines on cards; chart elements use thin uniform strokes (1-1.5px feel) |+| Texture | None — clean digital surfaces |+| Depth | Uniform 8% soft drop shadows under cards; no inset/raised effects |+| Material | Flat with deliberate elevation hierarchy via shadows |+| Mood | Polished, restrained, product-fluent |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page product demo | 600×500 | ~1.2 | 10% (dashboards lean toward edge-aligned cards) |+| Hero product showcase | 1200×600 | 2:1 | 10% |+| Spot dashboard tile | 400×300 | 4:3 | 8% |+| Full-bleed product hero | 1280×720 | 16:9 | 10% |++## Using the deck's HEX values++- Primary HEX: dominant chart element / featured card header+- Secondary HEX: background canvas (usually pale or near-white)+- Accent HEX: the single highlighted data point or focal metric+- Optional 4th: a muted neutral for secondary chart elements (gray bars, faded sparklines)++## Fewshot prompt snippets++**Snippet A — half-page product demo, text_policy: none**++> Polished digital dashboard UI aesthetic. Three rounded-corner cards arranged in a clean grid on a soft secondary background `#F8FAFC`. The largest card (top, occupying 60% of the area) shows a stylized line chart trending upward in primary blue `#0EA5E9` — three line segments, smooth curve, anchor dots at peaks. Two smaller cards below show: (left) a stylized donut chart with the primary color filling about 70% of the ring, (right) a simple KPI tile with a large iconic upward arrow in accent green `#10B981`. All cards have 8-12px rounded corners and uniform 8% soft drop shadows. Pixel-aligned edges. Composed as a 600×500 half-page block with 10% inner padding. NO text, no numbers, no chart labels, no axes — pure visual chart elements only. Color values are rendering guidance only.++**Snippet B — hero product showcase, text_policy: none**++> Polished SaaS dashboard hero image. A large central rectangular card occupies 75% of the canvas with 12px rounded corners and a soft 8% drop shadow, sitting on a clean secondary background `#F1F5F9`. The card surface shows a stylized analytics screen — a tall vertical bar chart on the left using primary navy `#1E3A8A` with one accent orange `#F97316` bar highlighted, a line chart on the right with two intersecting trend lines, and three small KPI tiles across the top. All chart elements are stylized — recognizable as charts but without specific values, axes, or labels. Background field is calm and uncluttered. Composed for a 1200×600 hero band with 10% inner padding. NO text, no numbers, no axis labels, no captions anywhere. Color values are rendering guidance only.++## What to avoid++- Real numbers, real labels (model often invents misleading values)+- Photorealistic device frames (laptop bezel, phone shell) unless explicitly intended+- Overly busy charts — keep to 3-5 chart elements maximum+- Skeuomorphic depth (glass, metal, gloss) — keep it flat-modern++## When to switch away++- For non-product visuals → `vector-illustration` or `flat`+- For technical architecture with 3D forms → `3d-isometric`+- For schematic technical drawings → `blueprint`diff --git a/skills/ppt-master/references/image-renderings/editorial.md b/skills/ppt-master/references/image-renderings/editorial.mdnew file mode 100644index 00000000..ce8d67b5--- /dev/null+++ b/skills/ppt-master/references/image-renderings/editorial.md@@ -0,0 +1,55 @@+# Rendering: editorial++Magazine-style infographic look — sophisticated layout, refined type-as-shape elements, restrained color, editorial pacing. The default choice for finance, journalism, explainers, opinion pieces, sophisticated B2B content.++## Style paragraph (paste-ready, 100 words)++> Magazine-style editorial illustration with sophisticated visual hierarchy and confident negative space. Elements are arranged with editorial pacing — one dominant focal area, deliberate alignment to invisible columns, generous gutters between blocks. Color is restrained and balanced — typically one rich brand tone, one neutral, one subtle accent. Geometric forms are simple but rendered with editorial confidence: bold blocks, refined dividers, accent rules. Optional duotone or limited-color treatment reinforces the magazine feel. Composition feels like a thoughtful magazine spread — not loud, not minimal, but considered. Overall mood is intelligent, premium, restrained, suitable for analytical and opinion content.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Refined — thin precise rules as dividers; clean filled shapes |+| Texture | Minimal — optional very subtle paper grain at 5-10% opacity |+| Depth | Flat with intentional layering; no shadows |+| Material | None — abstract editorial composition |+| Mood | Refined, intelligent, premium-restrained |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page editorial visual | 600×500 | ~1.2 | 15% (editorial wants breathing room) |+| Hero spread | 1200×600 | 2:1 | 14% |+| Square explainer | 700×700 | 1:1 | 15% |+| Spot illustration | 400×500 | 4:5 | 12% |++## Using the deck's HEX values++- Primary HEX: dominant block or background field if a saturated editorial mood is wanted+- Secondary HEX: gutters, dividers, background field (usually neutral)+- Accent HEX: one accent rule, one highlighted element++## Fewshot prompt snippets++**Snippet A — half-page financial explainer, text_policy: none**++> Magazine-style editorial illustration. The canvas is divided into a deliberate two-column composition — a tall block on the left occupying 40% of the width filled with primary deep navy `#0F2C4C`, and the right 60% as a calm secondary cream `#FAF7F2` field. Within the cream field, three stylized bar-chart elements rise from a baseline, each bar a different height, rendered in primary navy with thin uniform width. A thin accent rule in burnt orange `#C2410C` runs horizontally across the lower third connecting the navy block to the bars. One small circular accent marker in the same orange sits at the peak of the tallest bar. Subtle paper grain at 8% opacity across the canvas. Composed as a 600×500 half-page block with 15% inner padding. NO text, no labels, no numbers anywhere. Color values are rendering guidance only.++**Snippet B — hero opinion-piece spread, text_policy: none**++> Magazine-style editorial hero illustration. Wide canvas divided into three vertical bands at roughly 25%/50%/25% — the left band a saturated deep teal `#0F766E` filled solid, the center band a neutral cream `#FEFCE8` field, the right band a soft warm gray `#D4D4D8`. Centered in the cream field is a large simple geometric form — a circle with a single thin accent line in orange `#F97316` cutting horizontally across it. A thin editorial rule in deep teal runs vertically separating the bands. Subtle paper grain at 6% opacity. Composed for a 1200×600 hero band with 14% inner padding. NO text or labels. Color values are rendering guidance only.++## What to avoid++- Decorative ornament (editorial is restrained, not Victorian)+- Vibrant accent dominating the composition+- Cluttered multi-element compositions+- More than 3 colors++## When to switch away++- For approachable / friendly visuals → `sketch-notes`, `warm-scene`+- For dashboard / product surfaces → `digital-dashboard`+- For technical schematic → `blueprint`diff --git a/skills/ppt-master/references/image-renderings/fantasy-animation.md b/skills/ppt-master/references/image-renderings/fantasy-animation.mdnew file mode 100644index 00000000..9892770c--- /dev/null+++ b/skills/ppt-master/references/image-renderings/fantasy-animation.md@@ -0,0 +1,58 @@+# Rendering: fantasy-animation++Ghibli/Disney-inspired hand-drawn animation warmth. Soft painterly forms, gentle lighting, expressive but simplified characters, dreamy atmosphere. Used for children's content, storybook brand narratives, healing/comforting themes, fairy-tale or whimsical decks.++## Style paragraph (paste-ready, 110 words)++> Hand-drawn animation style inspired by Ghibli and classic Disney storybook aesthetics. Forms are softly rendered with painterly fills and gentle outlines — never harsh, always warm. Color palette is warm and slightly desaturated, with pastel skies, soft greens, warm earth tones, occasional accents of magical color. Lighting is dreamy and atmospheric — soft window light, golden-hour glow, gentle morning haze. Characters (when present) are stylized in a friendly cartoon manner — large expressive eyes, simplified anatomy, warm body language. Subtle painterly brush texture across the image. Atmospheric perspective creates depth — foreground richer, background softer. Overall feel is dreamy, magical, comforting — children's storybook quality.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Soft hand-drawn outlines or no outlines, with painterly fills inside |+| Texture | Subtle painterly brush quality + atmospheric softness |+| Depth | Strong atmospheric perspective — distant elements paler and softer |+| Material | Hand-painted animation cel |+| Mood | Dreamy, magical, comforting, storybook |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page storybook visual | 600×800 | 3:4 | 10% |+| Hero story banner | 1200×600 | 2:1 | 10% |+| Square storybook | 700×700 | 1:1 | 10% |+| Cover hero | 1280×720 | 16:9 | 10% |++## Using the deck's HEX values++fantasy-animation reads HEX values through a **warm storybook filter**:++- Primary HEX: dominant warm scene color (sky, foliage, environment)+- Secondary HEX: lighter atmospheric tone (cream, soft sky, morning haze)+- Accent HEX: a small magical pop — perhaps the glow of a window, a flower, a key character element++## Fewshot prompt snippets++**Snippet A — half-page storybook scene, text_policy: none**++> Hand-drawn animation style inspired by Ghibli storybook aesthetics. A soft warm scene of a small cottage on a hillside with a winding path leading down to the foreground. Sky in warm cream-amber `#FEF3C7` transitions to a soft accent peach `#FED7AA` at the horizon. Hillside in gentle warm green-amber blending the deck's primary tone, with painterly brush texture. A simplified storybook tree in the foreground left, hand-drawn cartoon-warm style. A small warm-glowing window in the cottage adds a magical accent color. Atmospheric perspective — distant hills are paler and softer, foreground has more saturated color. Subtle painterly brush quality throughout. Composed as a 600×800 half-page block with 10% inner padding. Simplified storybook style — any figures are gentle cartoon silhouettes, no realistic faces. NO text or labels. Color values are rendering guidance only.++**Snippet B — children's brand hero, text_policy: none**++> Hand-drawn Ghibli-style hero banner. A whimsical scene of a soft meadow with three large stylized storybook trees, gentle hills, and a clear morning sky. Sky transitions from warm primary blue `#7DD3FC` (pastel-graded from the deck's primary) at the top to soft cream `#FEF3C7` at the horizon. Trees rendered with painterly soft outlines and gentle fills in warm greens and ambers. A small magical-looking accent flower in foreground right, glowing softly in accent coral `#F97316`. Subtle painterly brush texture across the entire image. Dreamy atmospheric lighting. Composed for a 1200×600 hero band with 10% inner padding. No realistic faces. NO text. Color values are rendering guidance only.++## What to avoid++- Sharp digital edges (defeats the painterly storybook feel)+- Photo-realistic rendering+- Dark / heavy moods (fantasy-animation is intentionally warm-light)+- Adult-themed content+- Specific Disney/Ghibli character likenesses (style-inspired only, never copying)++## When to switch away++- For modern flat aesthetic → `flat` or `vector-illustration`+- For watercolor without character storybook → `watercolor`+- For realistic photography → `corporate-photo`diff --git a/skills/ppt-master/references/image-renderings/flat.md b/skills/ppt-master/references/image-renderings/flat.mdnew file mode 100644index 00000000..82da1f43--- /dev/null+++ b/skills/ppt-master/references/image-renderings/flat.md@@ -0,0 +1,56 @@+# Rendering: flat++Modern flat design with bolder geometric blocks than `vector-illustration`. More design-forward, slightly more decorative confidence. Used when a deck wants to feel "brand-aware" rather than purely utilitarian.++## Style paragraph (paste-ready, 90 words)++> Modern flat design illustration with bold geometric blocks and confident color zones. Forms are simplified to essential silhouettes — circles, rectangles, triangles, rounded squares. No outlines, or very thin uniform outlines as a deliberate accent. Color is applied as flat solid fills with deliberate juxtaposition (one block of saturated color against a large field of neutral). Subtle layered overlap creates flat depth without shadows. Composition has clear visual hierarchy — one dominant block, one secondary, one accent. Overall feel is contemporary, brand-aware, designed with intention — common in product launch and marketing decks.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Often no outlines; when used, thin uniform stroke as accent only |+| Texture | None — flat color blocks |+| Depth | Through layered overlap and color contrast, not shadow |+| Material | Flat — color is brand identity, not material |+| Mood | Designed, intentional, slightly more expressive than vector-illustration |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Full-bleed background | 1280×720 | 16:9 | 12-15% |+| Half-page block | 600×500 | ~1.2 | 12% |+| Hero band | 1200×400 | 3:1 | 12% |+| Spot accent | 320×320 | 1:1 | 10% |++## Using the deck's HEX values++- Primary HEX: largest filled block, the dominant brand voice+- Secondary HEX: secondary block or large negative space+- Accent HEX: a single saturated callout block or geometric anchor+- Optional 4th neutral: dark text/anchor color (near-black or deck's text color)++## Fewshot prompt snippets++**Snippet A — half-page product visual, text_policy: none**++> Modern flat design illustration. One large rounded rectangle in primary deep teal `#0F766E` occupying the lower-left two-thirds of the canvas, slightly overlapped by a smaller circle in accent coral `#F97316` positioned upper-right. The remaining area is calm secondary cream `#FAFAF9`. No outlines, no shadows. A simple iconic symbol — a stylized package, rendered as a flat silhouette — sits within the teal block, white on teal. Composed as a 600×500 half-page block with 12% inner padding. NO text, letters, numbers, or labels anywhere. Color values are rendering guidance only — do not display HEX codes or color names as text.++**Snippet B — hero banner, text_policy: none**++> Modern flat design illustration banner. Three confident geometric blocks arranged across a wide canvas — a tall navy `#1E3A8A` rectangle on the left occupying the lower 70%, a circular orange `#F97316` accent center-right at mid-height, and a softer beige `#FEF3C7` rectangle filling the right third. Blocks subtly overlap, creating flat layered depth without shadows. The composition reads left-to-right with the orange circle as the focal anchor. Background is a single off-white `#FAFAFA`. Composed for a 1200×400 hero band with 12% inner padding. NO text, no labels. Color values are rendering guidance only.++## What to avoid++- Gradients within blocks (use `tech-neon` or `dark-cinematic` if a gradient is needed)+- Heavy outlines (switch to `vector-illustration`)+- Drop shadows simulating realism (flat is intentionally non-physical)+- More than 4 colors in one image++## When to switch away++- For 15+ page corporate decks needing utility over design flair → `vector-illustration`+- For tech architecture with depth → `3d-isometric`+- For educational warmth → `sketch-notes`diff --git a/skills/ppt-master/references/image-renderings/ink-notes.md b/skills/ppt-master/references/image-renderings/ink-notes.mdnew file mode 100644index 00000000..0619bc1f--- /dev/null+++ b/skills/ppt-master/references/image-renderings/ink-notes.md@@ -0,0 +1,61 @@+# Rendering: ink-notes++Pure white paper, black ink, sparse semantic color accents — the Mike Rohde sketchnote tradition. Sharper, more professional, more "manifesto" than `sketch-notes`. Used for methodology, Before-After essays, mindset-shift narratives, technical manifestos, professional visual-note style.++## Style paragraph (paste-ready, 105 words)++> Professional hand-drawn visual-note style on pure white paper. All line work is black ink with slight wobble — confident, intentional, with the human-hand quality of a thoughtful whiteboard session. Hand-lettered titles appear bold and slightly oversized (when text policy allows). Color is intentionally sparse — black ink dominates ~85% of the visible content, with one or two semantic accent colors (coral red for risk/emphasis, muted teal for positive/solution, dusty lavender for neutral categories) covering less than 10% of canvas combined. Backgrounds and shape fills are mostly empty white. Small doodle decorations — stars, dashes, dots — are minimal. Overall feel is professional, considered, manifesto-quality.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Black ink with slight wobble; confident medium weight |+| Texture | Pure white background; no paper grain |+| Depth | Flat |+| Material | Pen-on-paper |+| Mood | Professional, considered, manifesto |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page methodology block | 600×600 | 1:1 | 14% |+| Hero manifesto banner | 1200×500 | 2.4:1 | 14% |+| Before/After comparison | 1200×500 | 2.4:1 | 14% |+| Spot diagram | 500×500 | 1:1 | 12% |++## Using the deck's HEX values++ink-notes has a near-fixed visual language: **black ink + white background + 1-2 semantic accents**. This palette tendency may override `design_spec.colors`:++- Background: pure white `#FFFFFF` (do not replace with the deck's secondary unless it's already near-white)+- Lines and text: near-black `#1A1A1A` (do not replace with the deck's primary)+- Semantic accents: ink-notes traditionally uses coral red, muted teal, dusty lavender. The deck's `accent` HEX can serve as the emphasis color, but consider whether it carries the right semantic weight (red=risk, teal=positive, gold=highlight)++This makes ink-notes **the rendering most likely to deviate from the deck's HEX**. Reaffirm in the prompt that the ink-notes natural palette is intentional and the deck's primary HEX is reserved for the accent role.++## Fewshot prompt snippets++**Snippet A — Before/After methodology (comparison type), text_policy: embedded**++> Professional hand-drawn visual-note style on pure white background. Composition is a Before/After split — vertical hand-drawn divider down the center. Both sides use black ink line work with slight wobble. Left side ("Before") shows a simple stick-figure character with a frustrated posture, a speech bubble with hand-lettered "OLD WAY" in English block caps, and a small list of three hand-drawn dashes with brief 1-2 word annotations (e.g. "manual", "slow", "fragile"). Right side ("After") shows a confident stick-figure character with a clean checkmark above, hand-lettered "NEW WAY" in English block caps, and three checkbox-style annotations (e.g. "automated", "fast", "reliable"). A curved hand-drawn "mindset shift" arrow bridges left to right with a small hand-lettered label "the shift". Sparse semantic color: coral red `#E8655A` (the deck's accent) appears only on the left side's pain points; muted teal `#5FA8A8` appears only on the right side's positives. Total color accent area under 10% of canvas. NO Chinese characters — all hand-lettered text is short English keywords. Composed as a 1200×500 hero banner with 14% inner padding.++**Snippet B — framework diagram, text_policy: none**++> Professional hand-drawn visual-note framework on pure white background. Central rounded-rectangle "system" frame with four labeled rounded-rectangle sub-components arranged around it — top, right, bottom, left. All forms drawn in confident black ink with slight wobble. Thin hand-drawn arrows connect each sub-component to the central frame. Small dashed-border placeholder box at the bottom right indicates a "future" component. The accent color appears only as a single highlight ring around the central frame (the deck's accent HEX, kept under 8% of canvas area). NO labels, captions, text, letters, or numbers anywhere — pure ink structure only. Composed as a 600×600 half-page block with 14% inner padding. Color values are rendering guidance only.++## What to avoid++- Saturated color fills (ink-notes is intentionally minimal)+- Computer fonts (defeats the hand-lettered authenticity)+- Chinese characters in embedded text (use English keywords only)+- Cream paper (that's `sketch-notes`; ink-notes is pure white)+- Decorative excess (ink-notes is restrained, not whimsical)++## When to switch away++- For warm educational feel → `sketch-notes`+- For pure schematic without ink-style → `blueprint`+- For corporate flat illustration → `vector-illustration`+- For magazine restraint → `editorial`diff --git a/skills/ppt-master/references/image-renderings/nature.md b/skills/ppt-master/references/image-renderings/nature.mdnew file mode 100644index 00000000..986e535a--- /dev/null+++ b/skills/ppt-master/references/image-renderings/nature.md@@ -0,0 +1,58 @@+# Rendering: nature++Organic earthy illustration with botanical and natural motifs. Soft curves, organic shapes, earth-toned palette by default. Used for environmental / sustainability / wellness / outdoor / food / agriculture decks.++## Style paragraph (paste-ready, 95 words)++> Organic illustration style with botanical and natural motifs. Forms are softly curved and asymmetric — leaves, branches, organic curves, irregular shapes that feel grown rather than drawn. Color palette leans earthy and slightly muted — forest greens, warm earth browns, terracotta, soft cream, occasional sky blue. Outlines are minimal or absent; forms are defined by color and texture. Subtle organic textures (leaf veins, wood grain, stone speckle) appear sparingly. Composition emphasizes natural balance and breathing room — never grid-aligned. Overall feel is grounded, contemplative, sustainable — well suited to wellness, environmental, and outdoor content.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Minimal — forms defined by color, occasional thin organic line as accent |+| Texture | Subtle organic textures (leaf veins, wood grain) sparingly |+| Depth | Soft layering of natural elements, atmospheric perspective |+| Material | Earth-toned illustration |+| Mood | Grounded, contemplative, sustainable |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page nature visual | 600×800 | 3:4 | 12% |+| Hero environmental banner | 1200×600 | 2:1 | 12% |+| Square botanical | 700×700 | 1:1 | 12% |++## Using the deck's HEX values++nature has a strong tendency toward **earth-toned natural palette**. When the deck's HEX aligns (warm-earth, nature-organic palette), use directly:++- Primary HEX: dominant nature color (deep green, deep earth brown)+- Secondary HEX: light atmospheric tone (cream, soft sky)+- Accent HEX: a small natural pop (a flower, a fruit, a leaf vein)++If the deck's HEX is cool / corporate, nature may be the wrong rendering — consult the compatibility matrix.++## Fewshot prompt snippets++**Snippet A — half-page sustainability scene, text_policy: none**++> Organic illustration style with botanical motifs. A soft natural scene of a single tree on a gentle hill, with curving organic forms and earthy color palette. Tree foliage in primary deep forest green `#166534` with subtle leaf-vein texture at 12% opacity. Tree trunk in warm earth brown using a darker shade. Hill in soft secondary cream `#FEF3C7` with very gentle curve. Sky in pale soft blue suggesting morning. A small accent of warm yellow `#D4AF37` flowers at the base of the tree. No hard outlines — forms defined by color contrast and soft organic edges. Composed as a 600×800 half-page block with 12% inner padding. NO text or labels. Color values are rendering guidance only.++**Snippet B — hero wellness banner, text_policy: none**++> Organic botanical illustration banner. A horizontal composition of natural elements — a wide field of soft cream `#FEF3C7` with three large stylized organic leaf shapes arching across the canvas. Leaves rendered in varied earthy greens — primary forest `#166534`, a softer mid-green, and a pale sage — overlapping with intentional asymmetric balance. Subtle leaf-vein texture visible at 10% opacity on each leaf. A few small accent terracotta `#C2410C` berry-shaped circles scattered sparingly. Background includes soft suggestion of distant warm-cream sky. No hard outlines, all forms curved and organic. Composed for a 1200×600 hero band with 12% inner padding. NO text. Color values are rendering guidance only.++## What to avoid++- Geometric / grid-aligned composition (nature is asymmetric and organic)+- Saturated artificial colors (palette should feel earthy and slightly muted)+- Hard digital edges+- Tech / industrial subjects (wrong rendering family — use `vector-illustration`)++## When to switch away++- For corporate / tech decks → `vector-illustration` or `flat`+- For pure painterly atmosphere → `watercolor`+- For storybook character work → `fantasy-animation`diff --git a/skills/ppt-master/references/image-renderings/pixel-art.md b/skills/ppt-master/references/image-renderings/pixel-art.mdnew file mode 100644index 00000000..c2ee460e--- /dev/null+++ b/skills/ppt-master/references/image-renderings/pixel-art.md@@ -0,0 +1,59 @@+# Rendering: pixel-art++8-bit / 16-bit retro game aesthetic. Sharp pixel grid, limited palette, no anti-aliasing. Used for gaming decks, retro tech decks, nostalgic content, and game-flavored education/entertainment.++## Style paragraph (paste-ready, 90 words)++> 8-bit pixel art style with strict pixel-grid alignment and no anti-aliasing. All elements are constructed from discrete colored pixels — visible chunky pixel edges, sharp transitions between color blocks, no soft gradients. Color palette is limited and intentionally retro (often 16-32 distinct colors total). Forms are simplified to fit a low-resolution grid — small character sprites, blocky environments, iconic items. Optional 1-pixel-wide outlines in darker shades of the fill color add definition. Composition often references classic NES / SNES / arcade game framing. Overall feel is nostalgic, playful, retro-game — instantly recognizable.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Pixel-stepped — outlines built from individual pixels, no smooth lines |+| Texture | None beyond the pixel grid itself |+| Depth | Achieved through palette layering (lighter top pixels, darker bottom for shading) |+| Material | Pixel grid |+| Mood | Nostalgic, retro-game, playful |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Hero retro banner | 1200×500 | 2.4:1 | 12% |+| Half-page sprite scene | 600×500 | ~1.2 | 14% |+| Square scene | 700×700 | 1:1 | 14% |+| Spot pixel icon | 320×320 | 1:1 | 14% |++## Using the deck's HEX values++pixel-art uses HEX values as **palette slots**:++- Primary HEX: dominant character / object color+- Secondary HEX: background or terrain+- Accent HEX: highlight items, important markers, magical effects+- Optional 4th: a darker shade of primary used as outline pixels (typically 25% darker)++## Fewshot prompt snippets++**Snippet A — hero retro banner, text_policy: none**++> 8-bit pixel art hero banner with strict pixel-grid alignment and no anti-aliasing. A retro-game-style scene — small pixel character sprite standing on a tile floor in the foreground center, with a stylized pixel-art mountain in the background and a pixel sun in the upper right. Character outfit in primary deep blue `#1E40AF`, with 1-pixel outlines in a darker shade of the same blue. Background mountain in muted gray pixel blocks. Sky in soft secondary peach `#FED7AA`. Sun in accent gold `#D4AF37` rendered as a chunky pixel circle. All elements visibly pixel-stepped — no smooth curves. Limited color palette (around 12-16 distinct colors total). Composed for a 1200×500 hero band with 12% inner padding. Simplified pixel character — no detailed face. NO text or labels. Color values are rendering guidance only.++**Snippet B — half-page retro tech scene, text_policy: none**++> 8-bit pixel art half-page scene. A retro-game-style tech laboratory — pixel computer monitors arranged on pixel desks, with a pixel character sprite working at one of them. All elements built from discrete colored pixels with visible chunky edges. Monitors in primary deep navy `#1E3A5F` with bright accent cyan `#06B6D4` screens. Desks in warm wood-tone secondary pixels `#A16207`. Walls and floor in restrained gray pixels. Small pixel decorations — a coffee cup, a plant — add warmth. 1-pixel outlines in darker shades of each fill color. Limited palette (~16 colors total). Composed as a 600×500 half-page block with 14% inner padding. Pixel character simplified, no realistic face. NO text or labels. Color values are rendering guidance only.++## What to avoid++- Anti-aliasing or smooth gradients (defeats the pixel identity)+- Modern photo-realistic detail+- Too high resolution per element (pixel art is intentionally low-res)+- More than 32 distinct colors in one image+- Mixing pixel art with other rendering styles++## When to switch away++- For modern flat → `flat` or `vector-illustration`+- For 3D tech aesthetic → `3d-isometric`+- For dashboard / UI surfaces → `digital-dashboard`diff --git a/skills/ppt-master/references/image-renderings/screen-print.md b/skills/ppt-master/references/image-renderings/screen-print.mdnew file mode 100644index 00000000..85e4d43f--- /dev/null+++ b/skills/ppt-master/references/image-renderings/screen-print.md@@ -0,0 +1,59 @@+# Rendering: screen-print++Bold silkscreen poster art — flat color blocks, halftone textures, limited colors, bold silhouettes. Used for cultural / media / opinion / cinematic decks where a poster aesthetic carries the page.++## Style paragraph (paste-ready, 110 words)++> Bold silkscreen poster art with limited flat color palette and characteristic print textures. The composition uses 2-5 flat colors maximum — no gradients within shapes, just confident solid color blocks. Halftone dot patterns add texture in transition zones (dot density varying from dense to sparse). Slight color layer misregistration (one color block offset by 1-2 pixels from where it "should" be) gives an authentic silkscreen feel. Subjects are rendered as bold silhouettes with stencil-cut edges — no fine detail, no realistic anatomy. Subtle paper grain texture at 15% opacity. Composition emphasizes negative space and geometric framing. Overall feel is vintage poster art, cinematic, editorial-bold — suitable for cultural commentary and dramatic cover work.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Stencil-cut edges, slight roughness; no outlines on solid color blocks |+| Texture | Halftone dot patterns in transition zones; paper grain at 15% across canvas |+| Depth | Flat with figure-ground inversion — negative space tells secondary story |+| Material | Silkscreen + paper |+| Mood | Vintage poster, cinematic, editorial-bold |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Hero cover poster | 1280×720 | 16:9 | 10% |+| Half-page poster block | 600×800 | 3:4 | 8% (posters fill the frame) |+| Square poster | 700×700 | 1:1 | 8% |+| Chapter divider | 1200×400 | 3:1 | 10% |++## Using the deck's HEX values++screen-print works best with **2-5 colors maximum**. The deck's HEX triplet maps directly:++- Primary HEX: the dominant flat color block (often 40-50% of canvas)+- Secondary HEX: the background or contrasting block (40% of canvas)+- Accent HEX: emphasis color for a single focal element++For two-color (duotone) poster mood, drop secondary and use primary + accent only.++## Fewshot prompt snippets++**Snippet A — hero chapter divider poster, text_policy: none**++> Bold silkscreen poster art in cinematic style. Composition is a strong central silhouette of a single iconic shape — perhaps a stylized mountain or a confident geometric form — rendered as a flat block in primary deep teal `#0F766E` occupying the lower 60% of the canvas. Above the silhouette, a contrasting sky in accent orange `#F97316` fills the upper 40% with a single small circular sun shape near the upper right in cream `#FEF3C7`. The horizon line has slight halftone dot texture transitioning between the two color zones. Slight color misregistration — the orange block offset by about 2px from the teal silhouette. Subtle paper grain at 15% opacity across the canvas. Composed for a 1200×400 chapter divider banner with 10% inner padding. NO text or labels. Color values are rendering guidance only — do not display HEX codes or color names as text.++**Snippet B — half-page editorial poster, text_policy: none**++> Bold silkscreen poster art with limited two-color palette and characteristic print textures. The composition is a stylized human silhouette (simplified, no facial features) standing center-left, rendered as a flat block in primary navy `#1E3A5F`. Behind the figure, a large flat circle in accent burnt orange `#C2410C` fills the upper-right quadrant — a "rising sun" composition. Halftone dot texture transitions between the orange and a soft cream background `#FEF3C7` along the circle's lower edge. Slight color misregistration on the silhouette. Paper grain texture at 15%. Composed as a 600×800 half-page block with 8% inner padding. Simplified silhouette — no facial details. NO text or labels. Color values are rendering guidance only.++## What to avoid++- Smooth gradients (defeats the silkscreen identity)+- Fine anatomical detail (poster art uses bold silhouettes)+- More than 5 colors (silkscreen is limited-color by definition)+- Realistic photography (this is intentionally stylized)++## When to switch away++- For flat illustration without poster textures → `flat` or `vector-illustration`+- For cinematic mood without poster aesthetic → `warm-scene` or `dark-cinematic` palette + `vector-illustration`+- For magazine restraint → `editorial`diff --git a/skills/ppt-master/references/image-renderings/sketch-notes.md b/skills/ppt-master/references/image-renderings/sketch-notes.mdnew file mode 100644index 00000000..8e321b12--- /dev/null+++ b/skills/ppt-master/references/image-renderings/sketch-notes.md@@ -0,0 +1,60 @@+# Rendering: sketch-notes++Warm cream paper with black hand-drawn lines and soft pastel color blocks. The most "approachable" rendering — used in education, training, onboarding, science communication, knowledge content where warmth and friendliness matter more than corporate precision.++## Style paragraph (paste-ready, 110 words)++> Warm hand-drawn sketchnote style on cream paper background. All lines are drawn with deliberate slight wobble — black ink on cream, never perfectly straight, with the human-hand quality that makes the image feel like a thoughtful teacher's whiteboard. Color blocks are soft pastels — light blue, mint, lavender, peach — filled into rounded shapes that don't quite reach their outlines (a deliberate "hand-painted overshoot" feel). Simple cartoon icons and small doodle decorations (stars, sparkles, dots, underlines) appear sparingly to add warmth. Composition is airy and well-organized, with generous white space between elements. Overall feel is warm, instructional, friendly — the visual language of educational explainer videos and knowledge cards.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Hand-drawn black ink with slight wobble; uniform medium weight |+| Texture | Subtle paper grain at 8-12% opacity over cream background |+| Depth | Flat — sketchnote is intentionally 2D |+| Material | Paper + ink + pastel block (hand-painted overshoot) |+| Mood | Warm, instructional, friendly |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page educational block | 600×600 | 1:1 | 14% |+| Hero teaching banner | 1200×500 | 2.4:1 | 14% |+| Square explainer | 700×700 | 1:1 | 16% |+| Spot icon-doodle | 400×400 | 1:1 | 12% |++## Using the deck's HEX values++sketch-notes has a strong **built-in palette tendency** toward warm cream + black ink + soft pastels. When the deck's `design_spec.colors` align (warm-earth or macaron palette family), use them directly. When they don't align (cool-corporate primary), sketch-notes may be the wrong rendering — consult the compatibility matrix in `image-palettes/_index.md`.++- Cream paper background: keep close to the rendering's natural `#F5F0E8` even if `design_spec.secondary` differs slightly (the cream **is** part of sketch-notes)+- Black ink lines: keep at `#1A1A1A` or near-black — do not replace with the deck's primary+- Pastel color blocks: the deck's primary / secondary / accent HEX values, **rendered as soft pastel tints** rather than full saturation+- Single emphasis accent: the deck's accent HEX, used in 1-2 strong sparing places (a key arrow, an emphasized doodle)++## Fewshot prompt snippets++**Snippet A — half-page educational concept, text_policy: embedded**++> Warm hand-drawn sketchnote on warm cream paper background. Black ink lines with slight wobble define three rounded rectangle info boxes arranged in a soft triangle layout. Each box is filled with a soft pastel block color: top box in light blue (a pastel tint of the deck's primary `#1E3A5F`), bottom-left box in mint, bottom-right box in lavender. Color fills don't completely reach the outlines (slight hand-painted overshoot). Hand-drawn wavy arrows connect the boxes — each arrow with a small inline hand-lettered English keyword like "leads to", "becomes", "supports" (no Chinese characters; ≤2 words per arrow). Each box contains one simple hand-drawn cartoon icon — a lightbulb, a plant, a gear — in black ink. Small doodle decorations (a few stars, dots, sparkles) sparingly around the composition. Composed as a 600×600 half-page block with 14% inner padding. Generous white space. Color values are rendering guidance only — do not display HEX codes or color names as text.++**Snippet B — hero teaching banner, text_policy: none**++> Warm hand-drawn sketchnote teaching banner on warm cream paper background with subtle paper grain at 10% opacity. Five rounded info boxes arranged in a horizontal flow across the canvas, connected by hand-drawn wavy black-ink arrows with slight wobble. Each box is filled with a different soft pastel block color cycling through: light blue, mint, lavender, peach, soft coral. Color fills have deliberate hand-painted overshoot beyond their outlines. Each box contains one simple hand-drawn cartoon icon in black ink — a seed, a sprout, a young plant, a tree, a forest — telling a growth story without text. Small doodle decorations (a few stars and dashes) scattered sparingly around the boxes. Composed for a 1200×500 hero band with 14% inner padding. NO text, letters, numbers, or labels anywhere. Color values are rendering guidance only.++## What to avoid++- Perfect geometric precision (defeats the hand-drawn warmth — switch to `vector-illustration`)+- Saturated full-strength colors (sketch-notes uses pastels)+- Heavy black ink fills (sketch-notes uses outlines + pastel blocks, not heavy fills)+- Computer fonts in `text_policy: embedded` (the appeal is hand-lettering — but use English only)+- Chinese characters in embedded text (most models render CJK poorly; use English keywords)++## When to switch away++- For corporate / consulting decks → `vector-illustration` or `editorial`+- For methodology / Before-After / mindset shift → `ink-notes`+- For classroom blackboard feel → `chalkboard`+- For storybook warmth → `fantasy-animation` or `watercolor`diff --git a/skills/ppt-master/references/image-renderings/vector-illustration.md b/skills/ppt-master/references/image-renderings/vector-illustration.mdnew file mode 100644index 00000000..059c5391--- /dev/null+++ b/skills/ppt-master/references/image-renderings/vector-illustration.md@@ -0,0 +1,61 @@+# Rendering: vector-illustration++The default safe rendering for general PPT decks. Clean flat vector art with bold shapes, deliberate geometry, and confident negative space. Scales reliably across 15+ slide decks without visual fatigue.++## Style paragraph (paste-ready, 95 words)++> Clean flat vector illustration with bold geometric shapes and confident solid fills. Crisp outlines (1.5-2px equivalent stroke weight, consistent across all elements) define every form. No gradients within shapes — color is applied as flat blocks. Subtle shadow only where it adds depth (soft 8% opacity drop, no harsh edges). Composition is grid-aware and balanced, with deliberate negative space carrying as much weight as filled areas. Iconography is simplified to essential geometry — recognizable at small sizes. Overall feel is modern, professional, and confidently restrained — a quality often called "design-system aesthetic" in product/SaaS contexts.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Clean vector outlines, uniform stroke weight, sharp corners or consistent rounded radius |+| Texture | None — flat fills only. No noise, no paper grain, no painterly artifacts |+| Depth | Optional 8% soft drop shadow under elevated elements; no perspective rendering |+| Material | None — color is information, not material simulation |+| Mood | Neutral-positive, professional, designed |++## Container sizing for local PPT inserts++| Embedded position | Recommended canvas | Aspect | Inner padding |+|---|---|---|---|+| Full-bleed background | 1280×720 | 16:9 | 15% all sides (the central 70% must be calm for SVG overlay) |+| Half-page illustration | 600×500 | ~1.2 | 12-15% |+| Quarter-page accent | 400×300 | 4:3 | 10-12% |+| Hero band (top) | 1200×400 | 3:1 | 15% top/bottom, 10% sides |+| Spot illustration | 320×320 | 1:1 | 8-10% |++## Using the deck's HEX values++vector-illustration treats colors as **flat coded zones**, not as gradients or shadows. Apply HEX values exactly — no tinting, no shading, no blend modes implied.++- Primary HEX: main shape fills, dominant elements+- Secondary HEX: background or large supporting blocks+- Accent HEX: highlight, key data point, or single emphasis element+- Lines and outlines: dark neutral (#222 or near-black) unless the deck's primary is dark enough to use directly++## Fewshot prompt snippets++**Snippet A — background block, text_policy: none**++> Clean flat vector illustration backdrop. Bold geometric shapes in flat solid fills — primary deep navy (#1E3A5F) forming a confident diagonal across the lower third, secondary light gray (#F8F9FA) occupying the upper two-thirds as calm breathing space, accent gold (#D4AF37) appearing only as one or two thin geometric lines drawing the eye toward the center. Crisp 2px outlines on all shapes. No gradients, no shadows beyond a single 8% soft drop. The central 70% of the canvas is deliberately calm and unbusy, ready to receive a slide title overlaid in SVG. Composed as a local PPT background block with 15% padding on all sides. Color values are rendering guidance only — do not display HEX codes, color names, or any labels as text in the image. NO text of any kind anywhere in the image — no letters, numbers, signs, watermarks, or written symbols.++**Snippet B — half-page methodology illustration, text_policy: none**++> Clean flat vector illustration. Five geometric forms arranged in a balanced grid — four rounded-square nodes in flat primary navy (#1E3A5F) at the corners, connected by thin secondary-gray (#F8F9FA) lines that converge on a single accent-gold (#D4AF37) circle at the center. Each node contains a simple iconic symbol — a gear, a chart bar, a chat bubble, an upward arrow — rendered in white on the navy fill. Crisp 1.5px outlines, uniform stroke weight throughout. Soft 8% drop shadow under each node for subtle depth. Composed for a 600×500 half-page slide block with 15% inner padding — central elements should feel calm and balanced, edges leave breathing room. NO text, letters, or numbers anywhere in the image — labels will be added later as SVG overlay. Color values are rendering guidance only. Simplified iconic symbols only — no realistic faces, no detailed anatomy.++## What to avoid++- **Gradients within shapes** — destroys the flat-vector feel; if depth is needed, use a single soft drop shadow+- **Mixed stroke weights** — every outline should be the same width+- **Photographic / hyperreal textures** — wrong rendering family; switch to corporate-photo if photo is needed+- **More than 3-4 distinct colors** — vector-illustration relies on color restraint; if more shades creep in, reduce+- **Tag-soup prompts** — write the style paragraph as prose, not as comma-separated keywords++## When to switch away from vector-illustration++- If the deck is **education / training / 教学**, sketch-notes is warmer+- If the deck is **tech architecture with depth**, 3d-isometric carries more presence+- If the deck is **data dashboards**, digital-dashboard is more authentic+- If the deck is **personal story / lifestyle**, watercolor or warm-scene fits betterdiff --git a/skills/ppt-master/references/image-renderings/warm-scene.md b/skills/ppt-master/references/image-renderings/warm-scene.mdnew file mode 100644index 00000000..6ce49487--- /dev/null+++ b/skills/ppt-master/references/image-renderings/warm-scene.md@@ -0,0 +1,58 @@+# Rendering: warm-scene++Golden-hour cinematic warmth — illustrated scenes with intentional warm lighting, soft shadows, atmospheric mood. Sits between `watercolor` (more painterly) and `corporate-photo` (more realistic). Used for personal growth stories, origin stories, brand narratives, lifestyle decks.++## Style paragraph (paste-ready, 100 words)++> Atmospheric scene illustration with golden-hour cinematic lighting. Forms are softly rendered — recognizable but not photo-realistic, with soft edges and intentional light direction. The scene has a clear primary light source (warm low sun, lamplight, window light) casting long soft shadows. Color palette leans warm and slightly desaturated — ambers, terracottas, cream highlights against deeper warm shadows. A subtle bloom or halo effect around the light source adds cinematic warmth. Composition follows narrative principles — foreground subject, middle ground context, atmospheric background. Overall feel is cinematic, contemplative, emotionally warm — well suited to brand story and personal narrative content.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Soft — forms defined by light and shadow, no hard outlines |+| Texture | Subtle painterly brush quality, optional very light film grain |+| Depth | Strong — foreground/middleground/background separation via atmospheric perspective |+| Material | Illustrated with golden-hour lighting |+| Mood | Cinematic, contemplative, warm |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page narrative | 600×800 | 3:4 | 10% |+| Hero story banner | 1200×600 | 2:1 | 10% |+| Wide scenic | 1200×500 | 2.4:1 | 10% |++## Using the deck's HEX values++warm-scene reads HEX values through a **warm-graded filter**:++- Primary HEX: dominant warm tone in shadows and midground (warm-graded version of the deck's primary)+- Secondary HEX: highlight tone in the lit areas (warm cream, soft amber)+- Accent HEX: a small bright concentrated zone — sun bloom, lamp glow, key warm reflection++If the deck's primary is cool (navy, teal), warm-scene will subtly warm-grade it; if the deck's palette is already warm, the rendering reinforces it directly.++## Fewshot prompt snippets++**Snippet A — half-page personal story, text_policy: none**++> Atmospheric scene illustration with golden-hour cinematic lighting. A softly rendered figure (simplified silhouette, no detailed face) walks along a path in a warm landscape — the figure in the foreground left, the path leading to a small distant cabin in the middleground, soft warm hills in the atmospheric background. Strong golden warm light comes from the upper right (the sun near the horizon), casting long soft shadows toward the left. Sky transitions from amber `#D97706` at the horizon to soft cream `#FEF3C7` at the top. Foreground shadows in deeper warm primary `#7C2D12`. Subtle bloom around the sun. No hard outlines — forms emerge from light and shadow. Subtle film grain at 8% opacity. Composed as a 600×800 half-page block with 10% inner padding. Simplified silhouette figures only — no realistic faces. NO text or labels. Color values are rendering guidance only.++**Snippet B — hero origin-story banner, text_policy: none**++> Atmospheric scene hero banner with golden-hour cinematic lighting. A wide warm scene — perhaps an early morning workspace with soft window light streaming in from the left, casting long shadows across a wooden desk in the middleground. Background suggests a window with warm cream `#FEF3C7` and amber `#D97706` light. Foreground objects are simplified — a notebook, a coffee cup, a small plant — defined by light and shadow rather than outlines. Strong directional light creates depth through atmospheric perspective. Cinematic warm grading, slight film grain. Composed for a 1200×600 hero band with 10% inner padding. No people, or simplified silhouettes only. NO text or labels. Color values are rendering guidance only.++## What to avoid++- Cool / neutral color grading (defeats the warm identity — switch to `watercolor` for cool atmospheric)+- Photo-realistic faces (use simplified silhouettes; for real people use `corporate-photo`)+- Sharp digital edges (warm-scene is soft cinematic)+- Cluttered scenes (atmosphere needs negative space)++## When to switch away++- For pure watercolor painterly feel → `watercolor`+- For real photography → `corporate-photo`+- For corporate / technical → `vector-illustration` or `flat`diff --git a/skills/ppt-master/references/image-renderings/watercolor.md b/skills/ppt-master/references/image-renderings/watercolor.mdnew file mode 100644index 00000000..cbbd4d7e--- /dev/null+++ b/skills/ppt-master/references/image-renderings/watercolor.md@@ -0,0 +1,57 @@+# Rendering: watercolor++Painterly soft edges, color bleeding, organic flow. The most "artistic" rendering — used for lifestyle, travel, brand story, personal narrative, creative content where mood matters more than data clarity.++## Style paragraph (paste-ready, 100 words)++> Watercolor painting style with soft painterly edges and natural color bleeding. Forms emerge from washes of pigment rather than outlines — sometimes a subject is suggested by where the wash darkens, not by a line. Color pools and bleeds at edges, with characteristic "wet-on-wet" zones where one color transitions into another. Composition feels organic and intentional — not loose like a sketch, but flowing. Negative space is part of the artwork (untouched paper). Optional very subtle pencil lines suggest underlying structure without dominating. Overall feel is calm, contemplative, artistic — well suited to narrative pages and atmosphere-setting content.++## Line, texture, depth++| Aspect | Treatment |+|---|---|+| Line quality | Minimal — forms defined by color washes, not outlines |+| Texture | Paper grain at 12-18% visible, characteristic wash bleeding at edges |+| Depth | Achieved through color saturation gradient — saturated foreground, paler background |+| Material | Watercolor + cold-press paper |+| Mood | Calm, contemplative, artistic |++## Container sizing for local PPT inserts++| Position | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page atmospheric visual | 600×800 | 3:4 | 10% (watercolor often fills the frame) |+| Hero narrative banner | 1200×600 | 2:1 | 10% |+| Square mood piece | 700×700 | 1:1 | 12% |++## Using the deck's HEX values++watercolor uses HEX values as **wash pigments**, not flat fills:++- Primary HEX: dominant wash zone, with natural saturation gradient+- Secondary HEX: background wash or untouched paper field+- Accent HEX: a small concentrated pigment zone where saturation pools++## Fewshot prompt snippets++**Snippet A — half-page narrative scene, text_policy: none**++> Watercolor painting style. A soft mountain landscape suggested by overlapping color washes — distant peaks in pale primary teal `#0F766E` bleeding into the upper third, midground hills in slightly more saturated teal with natural wet-on-wet color pooling, foreground in warm accent terracotta `#C2410C` suggesting a path or warm earth. Untouched paper at the very top creates a calm sky. No outlines defining the forms — they emerge from where the pigment darkens. Subtle paper grain texture at 15% opacity across the painting. Composed as a 600×800 half-page block with 10% inner padding. Atmospheric and contemplative. NO text, no labels anywhere. Color values are rendering guidance only.++**Snippet B — hero brand-story banner, text_policy: none**++> Watercolor painting style hero banner. Soft horizontal composition with pale washes flowing across the canvas. Left third in warm cream `#FEF3C7` (mostly untouched paper), center area in deeper amber `#D97706` with natural color pooling and bleeding edges, right third transitioning into deeper rust `#9A3412` accent. A few suggested forms — perhaps a tree silhouette emerging from the wash, perhaps a soft figure walking — defined entirely by color contrast, no outlines. Subtle pencil under-marks barely visible suggest underlying composition. Paper grain at 15% opacity. Composed for a 1200×600 hero band with 10% inner padding. NO text or labels. Color values are rendering guidance only.++## What to avoid++- Hard outlines (defeats the watercolor identity)+- Saturated solid fills (watercolor is washes)+- Digital-feeling sharp transitions+- Over-detailed subjects (watercolor suggests rather than describes)+- More than 3-4 colors in one painting++## When to switch away++- For golden-hour photographic warmth → `warm-scene`+- For corporate / technical visuals → `vector-illustration`, `flat`, `editorial`+- For storybook character work → `fantasy-animation`diff --git a/skills/ppt-master/references/image-type-templates/_index.md b/skills/ppt-master/references/image-type-templates/_index.mdnew file mode 100644index 00000000..1c45a2e1--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/_index.md@@ -0,0 +1,69 @@+# Type Templates — Index++A **type** describes what the image's **internal composition** looks like — its layout skeleton. Type is decided **per image**, not per deck (one deck typically uses 2-5 different types).++> **Type vs PPT page layout — important**: type describes the composition *inside* the AI image block. The PPT slide's overall layout (where the image sits, how SVG text wraps around it) is a separate decision made by Strategist and Executor. Type only governs what's inside the rectangle the model paints.+>+> **All types produce local blocks**: every type's container guidance assumes the image will be embedded inside a slide (left half, right column, hero band, accent corner). Full-page imagery is an escape hatch — see [`image-generator.md`](../image-generator.md) §0.++## Catalog (9 types)++Each type has its own file with: composition skeleton (LAYOUT / ELEMENTS / NEGATIVE SPACE), container sizing options, text-policy variants, fewshot snippets.++| Type | Internal composition | Typical use |+|---|---|---|+| [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 |+| [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 |+| [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 |+| [scene](scene.md) | Atmospheric environment with narrative | Story / lifestyle / case study |++---++## Auto-selection — per-image `Purpose` → type++For each row in `design_spec.md §VIII Image Resource List`, match `Purpose` against this table.++| `Purpose` keyword | Type | Default `text_policy` |+|---|---|---|+| Cover background / chapter background / divider bg | `background` | `none` |+| Product reveal / hero / headline visual | `hero` | `none` (or `embedded` for headline-as-image) |+| 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` |+| Comparison / Before-After / A/B / VS | `comparison` | `none` |+| History / evolution / roadmap / timeline | `timeline` | `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.++## Default container sizes (when not specified by Image Resource List)++The Resource List's `Dimensions` column is authoritative. If absent, use these defaults for prompt assembly:++| Type | Default container | Aspect ratio |+|---|---|---|+| 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 |+| 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 |+| comparison | 1200×500 split / 600×500 each | 2.4 / 1.2 |+| timeline | 1200×350 banner | 3.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.++## How to use++1. Pick the type per row in the Image Resource List using the table above.+2. `read_file image-type-templates/<type>.md` — only the types actually used in this deck. Most decks use 2-4 types; load each at most once.+3. Apply the type's composition skeleton when assembling the prompt, alongside the locked deck-wide rendering and palette.++**Multiple types per deck is normal.** Locking is at rendering + palette level, not type level.diff --git a/skills/ppt-master/references/image-type-templates/background.md b/skills/ppt-master/references/image-type-templates/background.mdnew file mode 100644index 00000000..bef2f330--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/background.md@@ -0,0 +1,76 @@+# Type: background++Atmospheric backdrop with **no central subject**. The image's job is to set tone and provide a calm field for SVG text overlay. The most common type for PPT covers, chapter dividers, and breathing pages.++> **What background means inside a PPT block**: the image is **all atmosphere, no subject**. Unlike `hero`, there is no dominant figure. Unlike `infographic`, there are no labeled zones. Background is pure ambience.++## Composition skeleton++```+ ┌────────────────────────────────────┐+ │ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │+ │ ░ atmospheric gradients ░ │+ │ ░ + subtle geometric anchor ░ │+ │ ░ (corner / edge, not center) ░ │+ │ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │+ └────────────────────────────────────┘+ ↑+ Center 60% is intentionally calm+ (SVG title will overlay here)+```++| LAYOUT | Atmospheric field — gradient, subtle pattern, or restrained color block composition. No dominant subject |+| ELEMENTS | Optional small geometric anchor in a corner or along an edge (a line, a small shape, a subtle motif). Never centered |+| NEGATIVE SPACE | The center 60-70% must be calm — low visual weight, ready to receive SVG title/text overlay |+| TEMPERAMENT | Sets the deck's overall tone: corporate-restrained, warm-friendly, tech-energetic, etc. |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Padding |+|---|---|---|---|+| Cover full-bleed | 1280×720 | 16:9 | The "padding" is the calm center zone, ~30% of total area unbusy |+| Chapter divider full-bleed | 1280×720 | 16:9 | Same |+| Half-page background (image left, text right) | 600×720 | ~0.83 | Calm zone on the text-adjacent edge |+| Hero band background | 1200×400 | 3:1 | Calm zone in the center band |++> Backgrounds are nearly always used full-bleed within a slide — but `page_role` stays `local` because SVG text overlays the image. Only use `page_role: full_page` when the user explicitly wants no SVG content on top.++## Text-policy variants++### `text_policy: none` (essentially always)++Backgrounds are atmospheric — adding text to a background defeats its purpose. **Always use `text_policy: none`** for this type unless there is a very specific reason otherwise.++Sample fragment:++> NO text of any kind anywhere in the image — no letters, numbers, signs, watermarks, labels, or written symbols. The image is pure atmosphere; SVG text overlay will be added externally.++### `text_policy: embedded` (rare)++Only when the user explicitly wants a "headline-on-textured-bg" effect — but in PPT Master this is almost always better as `typography` type or as `hero` type. Re-evaluate the type choice before using embedded text policy on background.++## Fewshot prompt snippets++**Snippet A — vector-illustration + cool-corporate cover background, text_policy: none, 1280×720**++> Clean flat vector illustration backdrop. Atmospheric composition with no central subject — bold geometric shapes arranged along the canvas edges to leave the center calm. Primary deep navy `#1E3A5F` forms a confident diagonal block across the lower-left third; secondary light gray `#F8F9FA` occupies the upper two-thirds as breathing space; accent gold `#D4AF37` appears only as one thin geometric line near the lower right corner (under 5% of canvas). Crisp 2px outlines, no gradients, single 8% soft drop shadow under the navy block. The central 60% of the canvas is deliberately calm and unbusy — designed to receive a slide title overlaid in SVG. Composed as a 1280×720 full-bleed PPT background. NO text, letters, numbers, signs, watermarks, or written symbols anywhere in the image. Color values are rendering guidance only — do not display HEX codes or color names as text. Simplified geometric shapes only.++**Snippet B — watercolor + warm-earth chapter divider background, text_policy: none, 1280×720**++> Watercolor painting style background. Soft warm washes flow across the canvas with no central subject — gentle horizontal bands of color. Upper third: pale cream `#FEF3C7` (mostly untouched paper). Middle band: soft amber `#D97706` with natural color pooling and bleeding edges. Lower third: deeper warm terracotta `#9A3412` with subtle paper grain at 15% opacity. No defined forms — just atmospheric color flow. The central 60% of the canvas is calm enough for slide title overlay. Composed as a 1280×720 full-bleed chapter divider background. NO text anywhere in the image. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Image has a dominant central subject | Subject crept in despite "no subject" intent | Reaffirm "atmospheric, no central subject, no dominant figure" |+| Center too busy for text overlay | Visual elements weren't pushed to edges | Add explicit "center 60% must be calm and unbusy, low visual weight" |+| Generic / forgettable image | Atmosphere was vague | Strengthen with specific atmospheric mood (golden-hour, digital-twilight, paper-and-ink) |+| Text appeared anyway | `text_policy: none` rule too weak | Strengthen with full exclusion list |++## When to switch away from background++- If the image needs a **dominant subject** → `hero`+- If the image carries **structured information** → `infographic`, `framework`, `flowchart`, `comparison`, `timeline`+- If the image carries **headline text as visual** → `typography`+- If the image is a **narrative scene with people/place** → `scene`diff --git a/skills/ppt-master/references/image-type-templates/comparison.md b/skills/ppt-master/references/image-type-templates/comparison.mdnew file mode 100644index 00000000..23ea5400--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/comparison.md@@ -0,0 +1,88 @@+# Type: comparison++Split composition showing two opposing sides — left vs right, before vs after, A vs B, traditional vs new. Used for pros/cons pages, mindset-shift narratives, option evaluations, transformation stories.++> **What comparison means inside a PPT block**: the image internally has **two symmetric or near-symmetric halves** with clear divider. Each half represents one option/state. Unlike all other types, comparison's signature is the **explicit duality**.++## Composition skeleton++Two sub-structures:++### Sub-structure 1 — Horizontal split (most common)++```+ ┌────────────┬────────────┐+ │ │ │+ │ LEFT │ RIGHT │+ │ (before, │ (after, │+ │ option A)│ option B)│+ │ │ │+ └────────────┴────────────┘+```++### Sub-structure 2 — Vertical split++```+ ┌──────────────┐+ │ TOP │+ │ (before) │+ ├──────────────┤+ │ BOTTOM │+ │ (after) │+ └──────────────┘+```++| LAYOUT | Two near-equal halves with a clear divider (vertical or horizontal). Each half contains its own content |+| ELEMENTS | Each side has its own anchor element (a figure, an icon cluster, a chart, a stylized scene). Visual treatment is symmetric in structure, distinct in content |+| NEGATIVE SPACE | 12-15% padding on the outer edges; the divider may be a thin line, geometric shape, or simply negative space |+| DIVIDER | Clean — a hand-drawn line, a vertical rule, a geometric shape, or just empty space. Should feel intentional |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Sub-structure fit |+|---|---|---|---|+| Hero before/after banner | 1200×500 | 2.4:1 | Horizontal split ✓✓ |+| Square comparison | 700×700 | 1:1 | Horizontal ✓ or vertical ✓ |+| Half-page comparison | 600×500 | ~1.2 | Horizontal split (compressed) ✓ |+| Tall comparison (vertical split) | 500×700 | ~0.7 | Vertical split ✓✓ |++Inner padding: 12-15% per side.++## Text-policy variants++### `text_policy: none`++Each side contains a visual anchor (figure, icon, scene) but no text labels. SVG labels added externally to indicate "Before / After" or "A / B".++### `text_policy: embedded`++Each side may contain short hand-lettered labels: "BEFORE" / "AFTER" at the top, plus 2-3 short English bullet words inside (e.g. "slow / manual / fragile" vs "fast / automated / reliable").++> ink-notes + comparison + embedded is a classic combination — the "manifesto Before/After" page.++## Fewshot prompt snippets++**Snippet A — ink-notes + mono-ink, Before/After horizontal split, text_policy: embedded, 1200×500**++> Professional hand-drawn visual-note style on pure white background `#FFFFFF`. The composition is a Before/After horizontal split with a clean vertical hand-drawn divider down the center. Both sides use confident black ink line work with slight wobble. Left side ("Before"): a simplified stick-figure character with frustrated posture, a speech bubble in hand-lettered English caps reading "OLD WAY", and three small hand-drawn dashes with brief 1-word annotations ("manual", "slow", "fragile"). Right side ("After"): a confident stick-figure character with a checkmark above, hand-lettered "NEW WAY" caps label, and three checkbox-style annotations ("automated", "fast", "reliable"). A curved "shift" arrow bridges left to right at mid-height. Sparse semantic accent: coral red `#E8655A` only on left-side pain markers (about 4% area); muted teal `#5FA8A8` only on right-side positive markers (about 3% area). Total color accent under 8%. Composed as a 1200×500 hero banner with 14% inner padding. English-only hand-lettered text. NO Chinese characters. Color values are rendering guidance only.++**Snippet B — vector-illustration + cool-corporate, two-option horizontal split, text_policy: none, 600×500**++> Clean flat vector illustration comparison. Composition is a horizontal split with a thin vertical accent gold `#D4AF37` divider line down the center. Both halves use crisp vector geometry on a secondary light gray `#F8F9FA` background. Left half contains a stylized geometric form representing Option A — three stacked rectangles in primary deep navy `#1E3A5F` with crisp 2px outlines, soft 8% drop shadow. Right half contains a contrasting geometric form representing Option B — a single larger rounded square in the same navy with one accent gold corner highlight (about 4% area). Both halves are visually balanced — same total visual weight, different structural treatment. Composed as a 600×500 half-page block with 14% inner padding. NO text or labels — SVG labels added externally. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Halves unequal weight | Symmetry rule omitted | "Both halves visually balanced — same total visual weight, different content" |+| No clear divider | Divider rule too weak | Specify "clean visible divider between halves — vertical line, geometric shape, or intentional negative space" |+| Sides indistinguishable | Content distinctness too weak | "Each side has its own distinct anchor element; sides are visually contrasting" |+| Mixed text in `none` policy | Text discipline weak | Reaffirm "no labels or text in image — left/right labels added in SVG overlay" |+| CJK garbled in embedded | Chinese used | Switch to English short labels |++## When to switch away from comparison++- If three+ options → `infographic` (parallel zones)+- If sequential transformation (no fixed before/after) → `flowchart`+- If concept with relations → `framework`+- If story / narrative scene → `scene`diff --git a/skills/ppt-master/references/image-type-templates/flowchart.md b/skills/ppt-master/references/image-type-templates/flowchart.mdnew file mode 100644index 00000000..c10a0f10--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/flowchart.md@@ -0,0 +1,98 @@+# Type: flowchart++Sequential blocks connected by arrows, showing process / workflow / pipeline. Used for "how-it-works" visuals, onboarding steps, pipeline diagrams, sequential methodologies.++> **What flowchart means inside a PPT block**: the image internally shows 3-6 stages in a clear directional sequence. Unlike `infographic` (parallel zones), flowchart has **direction**. Unlike `framework` (hub + satellites), flowchart has **sequence**.++## Composition skeleton++Three sub-structures:++### Sub-structure 1 — Horizontal flow (most common)++```+ ┌───┐ → ┌───┐ → ┌───┐ → ┌───┐+ │ 1 │ │ 2 │ │ 3 │ │ 4 │+ └───┘ └───┘ └───┘ └───┘+```++### Sub-structure 2 — Vertical flow++```+ ┌───┐+ │ 1 │+ └─┬─┘+ ↓+ ┌───┐+ │ 2 │+ └─┬─┘+ ↓+ ┌───┐+ │ 3 │+ └───┘+```++### Sub-structure 3 — Looping / cyclical++```+ ┌───┐ → ┌───┐+ │ 1 │ │ 2 │+ └───┘ └─┬─┘+ ↑ ↓+ ┌───┐ ← ┌───┐+ │ 4 │ │ 3 │+ └───┘ └───┘+```++| LAYOUT | 3-6 stage blocks with explicit connectors (arrows or lines with arrowheads) showing direction |+| ELEMENTS | Stages visually consistent (same shape, similar size); connectors uniform stroke weight; arrowheads consistent style |+| NEGATIVE SPACE | Generous around the flow — stages don't touch edges, connectors don't crowd |+| DIRECTIONAL CLARITY | The flow direction is unambiguous |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Sub-structure fit |+|---|---|---|---|+| Horizontal banner (3-5 stage flow) | 1200×400 | 3:1 | Horizontal flow ✓✓ |+| Half-page vertical (3-4 stages) | 500×700 | ~0.7 | Vertical flow ✓✓ |+| Square cyclical | 700×700 | 1:1 | Looping ✓✓ |+| Half-page horizontal (3 stages) | 600×400 | 1.5:1 | Horizontal compressed ✓ |++Inner padding: 14-16%.++## Text-policy variants++### `text_policy: none`++Each stage contains an iconic symbol only. Stage labels added in SVG overlay below or above the image.++### `text_policy: embedded`++Each stage may contain a short English keyword (≤2 words) inside or beside it.++## Fewshot prompt snippets++**Snippet A — vector-illustration + cool-corporate, horizontal 4-stage flow, text_policy: none, 1200×400**++> Clean flat vector illustration flowchart banner. Four rounded-rectangle stages arranged horizontally across the canvas, separated by uniform gaps. Each stage is filled with primary deep navy `#1E3A5F`, with crisp 2px outlines and 8% soft drop shadow. Between each pair of stages, a thin uniform horizontal arrow with a clean triangular arrowhead in secondary `#F8F9FA` or near-black. The third stage (highlighted as the focal stage) has a thin accent gold `#D4AF37` ring around it — under 5% accent area. Each stage contains one simple iconic symbol in white — an input arrow, a gear, a magnifier, an output arrow respectively. Background field is secondary light gray `#F8F9FA`. Composed for a 1200×400 hero band with 14% inner padding. NO text, letters, numbers, or labels — SVG labels added externally. Color values are rendering guidance only.++**Snippet B — blueprint + tech-neon, vertical 4-stage pipeline, text_policy: none, 500×700**++> Technical blueprint pipeline schematic, vertical orientation. Four rounded rectangle stages stacked vertically on a near-white background `#FAFAFA` with subtle grid pattern at 6% opacity in primary deep blue. Each stage uses 1.5px primary deep blue `#1E40AF` stroke; the second stage from top has its stroke replaced with accent vivid cyan `#06B6D4` as the focal stage. Between each pair of stages, a clean downward-pointing arrow with precise arrowhead in blueprint blue. Small anchor dots at line junctions. Each stage contains one iconic symbol in monoline schematic style — input symbol, transform symbol, validate symbol, output symbol. Composed as a 500×700 vertical pipeline with 14% inner padding. NO text or labels anywhere. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Arrows missing or unclear direction | Arrow rule too weak | Reaffirm "clear directional arrows between every consecutive stage, uniform arrowhead style" |+| Stages unequal size | Equality rule omitted | "All stages visually equal — same shape, similar size, same color treatment" |+| Stages too dense | Padding omitted | "Generous gaps between stages — stages don't crowd each other" |+| Flow direction ambiguous | Composition error | Explicit "flow reads left-to-right (or top-to-bottom)" |+| Cyclical not closing | Looping rule omitted (for cyclical only) | "Cyclical flow closes back to stage 1 via a return arrow" |++## When to switch away from flowchart++- If parallel zones without sequence → `infographic`+- If central hub with satellites → `framework`+- If two opposing options → `comparison`+- If time-ordered milestones → `timeline`diff --git a/skills/ppt-master/references/image-type-templates/framework.md b/skills/ppt-master/references/image-type-templates/framework.mdnew file mode 100644index 00000000..93893c45--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/framework.md@@ -0,0 +1,117 @@+# Type: framework++A central concept surrounded by related sub-concepts, or a multi-component system shown as a relational structure. Used when the image's job is to make a methodology, model, or architecture **legible at a glance**.++> **What framework means inside a PPT block**: the image *itself* is a small relational diagram — central hub + radiating satellites, or a labeled matrix, or a layered stack. The PPT page's slide layout (where this image sits, what text accompanies it) is a separate decision. This file only governs what's *inside* the image rectangle.++## Composition skeleton++Three valid sub-structures. Pick one per image; do not mix.++### Sub-structure 1 — Hub & spokes (most common)++```+ ◯+ \+ ◯ ─── ◆ ─── ◯+ /+ ◯+```++| LAYOUT | One central element (geometric anchor: circle, rounded square, diamond, hexagon) with 3-6 satellites positioned around it |+| ELEMENTS | Satellite nodes are visually consistent — same shape family, same size, same color treatment. Connecting lines are thin, clean, all the same weight |+| NEGATIVE SPACE | Generous radial breathing room — satellites should not feel cramped against the center or the canvas edge |+| BALANCE | Symmetric (satellites evenly distributed) OR deliberate asymmetric weighting (one satellite emphasized) — never accidental imbalance |++### Sub-structure 2 — Matrix (2×2 or 3×3)++```+ ┌──────┬──────┐+ │ │ │+ ├──────┼──────┤+ │ │ │+ └──────┴──────┘+```++| LAYOUT | Equal-sized cells in a grid; each cell carries one concept |+| ELEMENTS | One icon or symbolic shape per cell; cells are visually equal (no cell dominates unless that's the point — e.g. SWOT, BCG matrices) |+| NEGATIVE SPACE | Generous cell padding — internal content occupies the inner 70% of each cell |++### Sub-structure 3 — Layered stack++```+ ╔══════════════╗+ ║ layer 3 ║+ ╠══════════════╣+ ║ layer 2 ║+ ╠══════════════╣+ ║ layer 1 ║+ ╚══════════════╝+```++| LAYOUT | 3-5 horizontal bands stacked vertically; visual weight increases or decreases monotonically |+| ELEMENTS | Each layer has a consistent visual treatment; one icon or shape per layer |+| NEGATIVE SPACE | Equal-height bands with consistent gap between them; top and bottom padding to canvas edge |++## Container sizing for local PPT inserts++| Embedded position | Canvas | Aspect | Sub-structure fit |+|---|---|---|---|+| Square half-page (most common) | 700×700 | 1:1 | Hub & spokes ✓✓ / Matrix ✓✓ |+| Portrait half-page | 600×800 | 3:4 | Layered stack ✓✓ |+| Landscape banner | 1200×500 | 2.4:1 | Hub & spokes (flattened) ✓ / Matrix (1×N) ✓ |+| Full-bleed (page_role: full_page only) | 1280×720 | 16:9 | All three work — but require explicit user request |++Inner padding: 15-18% on all sides. Framework imagery suffers most when satellites/cells push against the canvas edge.++## Text-policy variants++### `text_policy: none` (default — recommended for most decks)++The image shows **only the geometric structure**. Labels for each satellite / cell / layer are added in SVG overlay around the image.++This is the recommended path because:+- SVG labels are editable, translatable, accurate+- The model can fail on text rendering; geometry it can do+- The page looks more polished with crisp vector text overlaying the AI art++Sample fragment to add to the prompt:++> Pure geometric structure — no labels, no captions, no text, no letters or numbers anywhere in the image. Each satellite/cell/layer contains a simple iconic symbol only (gear, arrow, chart, etc.). SVG text overlay will be added externally.++### `text_policy: embedded` (rare — for sketch-notes / ink-notes hand-lettered decks)++A short keyword (1-2 English words) appears inside or beside each satellite / cell / layer.++Sample fragment:++> Each satellite includes a single short hand-lettered keyword in English (≤2 words) — e.g. "data", "process", "growth". Keywords are part of the artwork, not labels. No long sentences, no numbers, no Chinese characters (most models render CJK characters incorrectly).++## Fewshot prompt snippets++**Snippet A — vector-illustration + cool-corporate, hub-and-spokes, `text_policy: none`, 700×700 half-page**++> Clean flat vector illustration with bold geometric shapes and confident solid fills. Crisp 2px outlines, no gradients, single 8% soft drop shadow under elevated elements. The composition is a hub-and-spokes framework: one central rounded-square node in primary deep navy `#1E3A5F` sits at the exact center; four satellite circles in the same navy are evenly distributed around it (top, right, bottom, left), connected to the center by thin straight lines in a darker neutral. Each satellite contains one simple iconic symbol in white fill — a gear, a chart bar, an upward arrow, a chat bubble — chosen for clear recognition at small sizes. Background is calm secondary light gray `#F8F9FA` carrying 65% of the canvas area. Accent gold `#D4AF37` appears only as one thin emphasis ring around the central node — under 5% of canvas area. Composed as a 700×700 half-page block with 16% inner padding on all sides — satellites breathe well within the canvas, no element touches the edge. No text, letters, numbers, or labels anywhere in the image — SVG labels will be added externally. Color values are rendering guidance only — do not display HEX codes or color names as text. Simplified iconic symbols only, no realistic faces.++**Snippet B — sketch-notes + macaron, matrix (2×2), `text_policy: embedded`, 700×700**++> Warm cream paper background `#F5F0E8` with subtle paper texture. Black hand-drawn lines with slight wobble, à la sketch-notes / hand-lettered educational style. Composition is a 2×2 matrix — four rounded rectangles arranged in a grid, each cell filled with a different pastel block color (light blue, mint, lavender, peach). Each cell contains one simple hand-drawn cartoon icon (a lightbulb, a chart, a person, a target) and one short hand-lettered English keyword (e.g. "ideas", "data", "team", "goal") — 1-2 words per cell maximum. Cells are separated by hand-drawn dividers with slight wobble. Generous white space around the matrix — internal cell content occupies the inner 70% of each cell. Color values are rendering guidance only — do not display HEX codes or color names as text. Hand-lettered keywords only in English; no long sentences, no numbers, no Chinese characters. Composed as a 700×700 half-page block with 18% inner padding on all sides.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Satellites uneven, asymmetric in unintended way | "Evenly distributed" omitted | Add explicit "evenly distributed around the center, equal spacing between satellites" |+| Center node lost among satellites | Center is same size/weight as satellites | Specify "center is visually dominant — larger and more saturated than satellites" |+| Lines connecting nodes look messy | Stroke weight not specified | Add "all connecting lines are thin, uniform stroke weight, perfectly straight" |+| Labels appearing despite `text_policy: none` | Prompt allowed iconic symbols loosely | Add "no labels, no captions, no text, no letters, no numbers — pure geometric structure only" |+| Garbled CJK characters in `embedded` | Chinese keywords requested | Switch keywords to English or accept manual regen |+| Image too dense, no room for SVG overlay | Padding rule omitted | Restate "15-18% inner padding on all sides, central content occupies inner 70%" |++## When to switch away from framework++- If the structure is **sequential / stepwise**, use `flowchart`+- If the structure is **two competing options**, use `comparison`+- If the structure is **chronological**, use `timeline`+- If the structure is **dominant single subject with smaller elements**, use `hero`+- If the structure is **pure backdrop with no internal structure**, use `background`diff --git a/skills/ppt-master/references/image-type-templates/hero.md b/skills/ppt-master/references/image-type-templates/hero.mdnew file mode 100644index 00000000..9b586565--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/hero.md@@ -0,0 +1,71 @@+# Type: hero++Single dominant subject occupying 60-70% of the canvas. The hero image *anchors* a slide — it's what the page is *about* visually. Used for product reveals, concept introductions, chapter title visuals, brand statement pages.++> **What hero means inside a PPT block**: one confident dominant subject with intentional supporting context. Unlike `background` (no subject), hero is **all about the subject**. Unlike `infographic` (multiple labeled zones), hero is **singular focal subject**.++## Composition skeleton++```+ ┌────────────────────────────────────┐+ │ │+ │ ┌──────────────┐ │+ │ │ │ │+ │ │ HERO │ │+ │ │ SUBJECT │ (60-70% │+ │ │ │ of canvas) │+ │ └──────────────┘ │+ │ │+ │ small supporting context only │+ └────────────────────────────────────┘+```++| LAYOUT | One dominant subject occupying 60-70% of the canvas area, positioned with intent (centered, slight left/right offset, or rule-of-thirds) |+| ELEMENTS | The hero subject + minimal supporting context (background environment, small accent elements). Supporting elements <30% of canvas |+| NEGATIVE SPACE | Generous around the subject — at least 15% padding on the subject's "open" side |+| BALANCE | Subject's visual weight clearly dominant; no second-place subject competing |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Padding |+|---|---|---|---|+| Half-page hero (image left/right of text) | 600×600 | 1:1 | 15% around subject |+| Full-bleed hero (subject + slide title overlay) | 1280×720 | 16:9 | 20% offset to keep title area clear |+| Hero band | 1200×500 | 2.4:1 | Generous side padding |+| Square hero | 700×700 | 1:1 | 15% |++## Text-policy variants++### `text_policy: none` (most common)++The hero subject is the visual; any title or label comes from SVG overlay.++### `text_policy: embedded` (occasional)++The hero subject itself includes a short embedded keyword (e.g. a product name on a package, a single hand-lettered word as part of the subject). Use sparingly — usually `typography` type is a better choice for headline-as-image.++## Fewshot prompt snippets++**Snippet A — 3d-isometric + tech-neon product reveal, text_policy: none, 600×600**++> 3D isometric illustration in true 30°/30°/30° projection. One dominant product-form subject — a stylized device or sleek tech object — occupies the center of the canvas at roughly 65% of the area. The subject is rendered in primary electric blue `#0EA5E9` on its lit faces, with 15% darker tonal shift on shadowed faces. A subtle 8%-opacity outer glow halo surrounds the subject. Small supporting context: three thin connecting lines in accent vivid cyan `#06B6D4` arcing from the subject toward the canvas edges (suggesting connectivity), and a soft 8% drop shadow grounding the subject. Background is deep secondary navy `#0A0E27` (about 30% of canvas, including shadowed plane). The subject is clearly the singular focal element. Composed as a 600×600 half-page hero block with 15% padding around the subject. NO text, letters, numbers, or labels anywhere. Color values are rendering guidance only.++**Snippet B — corporate-photo + warm-earth lifestyle hero, text_policy: none, 1280×720**++> Editorial photography style hero. A single dominant subject — perhaps a person in a workspace, or a product on a desk — fills 65% of the canvas, positioned slightly left of center to leave room for SVG title overlay on the upper right. Subject is photorealistically rendered with diverse, professionally attired styling, captured in natural window light with shallow depth of field. Color grading is warm-earth — image graded toward warm amber and cream, with primary terracotta `#9A3412` as dominant warm tone, secondary cream `#FEF3C7` as soft background, accent gold `#D4AF37` as a small contextual detail (a warm light source, a sunlit surface). Background is gently blurred contextual environment. Composed as a 1280×720 full-bleed hero with 20% offset on the upper right for SVG title clearance. Diverse, professionally attired subject rendered photorealistically. NO text or labels in the image. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Multiple subjects competing | Hero rule violated | Strengthen "ONE dominant subject, all other elements clearly supporting" |+| Subject too small | 60-70% rule omitted | Reaffirm "subject occupies 60-70% of canvas area" |+| Subject cropped at edges | Padding rule omitted | Restate "15% padding around the subject on all sides" |+| Background steals attention | Supporting context exceeded 30% | "Supporting context restrained, under 30% of canvas weight" |++## When to switch away from hero++- If the image is **pure atmosphere with no subject** → `background`+- If the subject is **headline text** → `typography`+- If multiple equal-weight elements → `infographic` or `framework`+- If narrative scene with people in environment → `scene`diff --git a/skills/ppt-master/references/image-type-templates/infographic.md b/skills/ppt-master/references/image-type-templates/infographic.mdnew file mode 100644index 00000000..987e9361--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/infographic.md@@ -0,0 +1,92 @@+# Type: infographic++2-5 ordered zones, each with an icon and minimal label/keyword. Used for data summaries, KPI rundowns, step lists, feature highlights, value propositions presented visually. **Used as a local block** — the AI image is a small information panel embedded in a slide.++> **What infographic means inside a PPT block**: the image internally is a 2-5-zone information panel. Unlike `framework` (hub + radiating satellites) or `flowchart` (sequential with arrows), infographic has **parallel zones** without strict ordering or directional flow.++## Composition skeleton++Two sub-structures:++### Sub-structure 1 — Grid (most common for infographic)++```+ ┌──────┬──────┐ ┌──────┬──────┬──────┐+ │ │ │ │ │ │ │+ ├──────┼──────┤ or └──────┴──────┴──────┘+ │ │ │+ └──────┴──────┘+ 2×2 (4 zones) 3×1 (3 zones)+```++### Sub-structure 2 — Radial (4-5 zones around a small center anchor)++```+ ◯+ \+ ◯─── · ───◯+ /+ ◯+```++| LAYOUT | 2-5 equal-weight zones arranged in grid or radial pattern. Each zone is visually distinct (own color/icon) but structurally equal |+| ELEMENTS | One icon per zone + (optional) one short keyword. Connecting lines NOT required (unlike framework/flowchart) |+| NEGATIVE SPACE | Generous between zones (10-15% gutters) and inside each zone (60-70% of zone for content, rest as padding) |+| BALANCE | Zones are visually equal — no zone dominates |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Sub-structure fit |+|---|---|---|---|+| Square half-page (2×2 grid) | 600×600 | 1:1 | Grid 2×2 ✓✓ / Radial 4-zone ✓ |+| Wide banner (3×1 grid) | 1200×400 | 3:1 | Grid 3×1 ✓✓ |+| Square radial | 700×700 | 1:1 | Radial 4-5 zones ✓✓ |+| Portrait list (3-4 zones vertical) | 500×700 | ~0.7 | Grid 1×3 or 1×4 ✓ |++Inner padding: 14-18%.++## Text-policy variants++### `text_policy: none`++Each zone contains an icon only. Labels added in SVG overlay around or below the image.++Sample fragment:++> Each zone contains one simple iconic symbol — chart bar, lightbulb, target, etc. No labels, no captions, no text or numbers anywhere in the image. SVG labels will be added externally.++### `text_policy: embedded`++Each zone contains an icon + one short English keyword (≤2 words).++Sample fragment:++> Each zone contains one iconic symbol and one short hand-lettered English keyword (1-2 words, e.g. "Speed", "Reach", "Trust"). Keywords are part of the artwork. No long sentences, no numbers, no Chinese characters.++## Fewshot prompt snippets++**Snippet A — vector-illustration + cool-corporate, 2×2 grid, text_policy: none, 600×600**++> Clean flat vector illustration infographic. The composition is a 2×2 grid of equal-sized rounded-rectangle zones, separated by clean gutters (about 12% of canvas width). Each zone has a solid fill in a different tint of the deck's palette: upper-left in primary deep navy `#1E3A5F`, upper-right in a slightly lighter navy tint, lower-left in another navy tint, lower-right with accent gold `#D4AF37` as the highlighted zone (about 7% of canvas total accent area). Crisp 2px outlines, single 8% soft drop shadow under each zone. Each zone contains one simple iconic symbol in white fill — chart bar (upper-left), lightbulb (upper-right), target (lower-left), upward arrow (lower-right). Background field secondary light gray `#F8F9FA` showing through the gutters. Composed as a 600×600 half-page block with 14% inner padding around the grid. NO text, letters, numbers, or labels anywhere — SVG labels added externally. Color values are rendering guidance only. Simplified iconic symbols, no realistic faces.++**Snippet B — sketch-notes + macaron, 3-zone vertical list, text_policy: embedded, 500×700**++> Warm hand-drawn sketchnote infographic on warm cream paper background `#F5F0E8`. Three rounded-rectangle zones arranged vertically with hand-drawn black ink wobbly outlines. Each zone has a different soft pastel fill (light blue top, mint middle, peach bottom) with slight hand-painted overshoot beyond outlines. Each zone contains one simple hand-drawn cartoon icon and one short hand-lettered English keyword: top zone with a lightbulb icon and "IDEAS", middle zone with a person icon and "TEAM", bottom zone with an upward arrow and "GROWTH". Hand-drawn wavy connector lines between zones (subtle). Small doodle decorations (a star, a dot) sparingly around the composition. Composed as a 500×700 vertical block with 16% inner padding. Hand-lettered text in English only, no numbers, no Chinese characters. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Zones unequal size | Equality rule omitted | Strengthen "all zones visually equal in size and weight" |+| Zones missing icons | Icon rule too vague | "Each zone contains exactly one iconic symbol" |+| Garbled keywords in embedded | CJK or too long | Switch to English, ≤2 words per zone |+| Connector lines appearing (becomes framework/flowchart) | Composition drift | Reaffirm "zones are parallel and equal — no connector lines, no arrows, no directional flow" |+| Center is overcrowded in radial | Center anchor too large | "Small center anchor only — satellites carry the content" |++## When to switch away from infographic++- If structure is **central hub + radiating elements** → `framework`+- If structure is **sequential with arrows** → `flowchart`+- If structure is **two opposing options** → `comparison`+- If structure is **time-ordered** → `timeline`+- If pure ambient backdrop → `background`diff --git a/skills/ppt-master/references/image-type-templates/scene.md b/skills/ppt-master/references/image-type-templates/scene.mdnew file mode 100644index 00000000..8313d04e--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/scene.md@@ -0,0 +1,73 @@+# Type: scene++Atmospheric environment with narrative — a moment, a place, a situation rendered as a small story. Used for case studies, brand storytelling, lifestyle pages, personal narrative slides.++> **What scene means inside a PPT block**: the image internally is **a moment in a place** — environment, figures (if any), atmosphere, mood. Unlike `hero` (single dominant subject), scene has **context and narrative**. Unlike `background` (no subject), scene has **inhabitants**.++## Composition skeleton++```+ ┌────────────────────────────────────┐+ │ sky / atmosphere (foreground │+ │ or upper area) │+ │ │+ │ figure / subject in environment │+ │ ↑ foreground │+ │ ──────────────────────────── │+ │ middle ground (context, objects) │+ │ ──────────────────────────── │+ │ background (atmospheric depth) │+ └────────────────────────────────────┘+```++| LAYOUT | Three-layer composition: foreground (subject + immediate context), middle ground (supporting environment), background (atmospheric depth). The viewer reads the scene like a small story |+| ELEMENTS | One or more figures (simplified silhouettes unless `corporate-photo`) in an environment. Environmental elements (sun, lamp, tree, desk) support the narrative |+| NEGATIVE SPACE | Atmospheric perspective creates breathing room — background paler than foreground |+| ATMOSPHERE | Lighting direction, color temperature, and mood are deliberate (golden-hour, evening light, morning haze, etc.) |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Padding |+|---|---|---|---|+| Hero scene banner | 1200×600 | 2:1 | 10% (scenes fill the frame) |+| Half-page narrative | 600×800 | 3:4 | 10% |+| Wide scenic | 1200×500 | 2.4:1 | 10% |+| Square scene | 700×700 | 1:1 | 10% |++## Text-policy variants++### `text_policy: none` (essentially always)++Scenes are visual narratives — text would interrupt. Use `text_policy: none`.++### `text_policy: embedded` (very rare)++Only when the scene includes a tiny diegetic text (a sign in the scene, a label on a book) — these often fail to render correctly. Usually better as `text_policy: none`.++## Fewshot prompt snippets++**Snippet A — warm-scene + warm-earth personal story, text_policy: none, 1200×600**++> Atmospheric scene illustration with golden-hour cinematic lighting. The composition is a three-layer narrative: foreground left — a softly rendered simplified figure silhouette walking along a path with warm long shadows cast toward the right; middle ground — the warm path winds into a stylized hillside with a few suggested trees; background — atmospheric perspective creates pale warm distance, sky transitioning from amber `#D97706` at the horizon to soft cream `#FEF3C7` at the top. Lighting is warm golden-hour from the upper right. Foreground in deeper warm primary `#9A3412`; small accent gold `#D4AF37` highlights on sunlit surfaces. No hard outlines — forms emerge from light and shadow. Subtle film grain at 8% opacity. Composed as a 1200×600 hero scene with 10% inner padding. Simplified silhouette figure only — no realistic face. NO text or labels. Color values are rendering guidance only.++**Snippet B — corporate-photo + warm-earth team scene, text_policy: none, 1200×600**++> Editorial photography of a small modern team collaborating around a workspace. Foreground: three diverse, professionally attired adults engaged in genuine conversation over a laptop and notebooks on a wooden desk. Middle ground: a colleague visible in the background, slightly out of focus, working on their own laptop. Background: large window with soft natural light streaming in, contemporary office context. Soft window light from the left creates warm-amber highlights on subjects' faces and equipment; deeper warm shadows in the desk area. Color grading warm-editorial — primary terracotta `#9A3412` in shadow tones, secondary cream `#FEF3C7` in highlights, accent gold `#D4AF37` on wood and a small warm desk-lamp glow. Shallow depth of field — foreground subjects sharp, middle/background gently blurred. Composed as a 1200×600 hero scene with 10% inner padding. Diverse, professionally attired subjects rendered photorealistically. NO text. Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| No foreground/midground/background depth | Layer rule omitted | "Three-layer composition: foreground, middle ground, background — atmospheric perspective creates depth" |+| Realistic faces in non-photo rendering | §3.2 omitted | Reaffirm "simplified silhouette figures only, no realistic faces" (exception: corporate-photo rendering) |+| Too many subjects competing | Narrative focus weak | "Clear narrative focus — one primary scene moment, supporting elements contextual not competing" |+| Mood inconsistent | Lighting direction not specified | "Single deliberate light source — direction explicit (e.g. upper right, warm golden-hour)" |+| Cluttered with detail | Scene too busy | "Atmospheric — scenes suggest rather than describe; restrained detail" |++## When to switch away from scene++- If pure atmosphere with no subject → `background`+- If single dominant subject without environment → `hero`+- If structured information with zones → `infographic`+- If conceptual relationships → `framework`+- If chronological progression → `timeline`diff --git a/skills/ppt-master/references/image-type-templates/timeline.md b/skills/ppt-master/references/image-type-templates/timeline.mdnew file mode 100644index 00000000..44374dcb--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/timeline.md@@ -0,0 +1,83 @@+# Type: timeline++Linear progression along a time axis — milestones, evolution, roadmap, history. Used for company history pages, product evolution, project roadmaps, era-by-era narratives.++> **What timeline means inside a PPT block**: the image internally has a clear **axis (horizontal or vertical)** with 3-6 milestone markers along it. Unlike `flowchart` (process with arrows), timeline is **about time positions**. Unlike `framework` (relational), timeline is **sequential and chronological**.++## Composition skeleton++Two sub-structures:++### Sub-structure 1 — Horizontal timeline (most common)++```+ ──●─────●─────●─────●─────●──+ | | | | |+ 2020 2021 2022 2023 2024+ icon icon icon icon icon+```++### Sub-structure 2 — Vertical timeline++```+ ●─── milestone 1+ │+ ●─── milestone 2+ │+ ●─── milestone 3+ │+ ●─── milestone 4+```++| LAYOUT | A clear axis (line) with 3-6 milestone markers (dots, small shapes) positioned along it. Each milestone has its associated visual element (icon, illustration) near it |+| ELEMENTS | Axis line is thin and uniform; milestone markers are visually consistent; iconic elements at each milestone are simple and parallel in style |+| NEGATIVE SPACE | Generous space above/below (or left/right) the axis to give milestones breathing room |+| TIME DIRECTION | Direction is unambiguous (left-to-right = earlier-to-later) |++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Sub-structure fit |+|---|---|---|---|+| Hero horizontal timeline | 1200×350 | 3.4:1 | Horizontal timeline ✓✓ |+| Wide timeline banner | 1200×500 | 2.4:1 | Horizontal with icons ✓✓ |+| Half-page horizontal (compressed) | 600×400 | 1.5:1 | Horizontal 3-4 stops ✓ |+| Tall vertical timeline | 500×800 | ~0.6 | Vertical timeline ✓✓ |++Inner padding: 12-15% on the axis's "open" sides.++## Text-policy variants++### `text_policy: none`++Each milestone has an iconic symbol only. Date labels and milestone descriptions added in SVG overlay.++### `text_policy: embedded`++Each milestone may include a short date (e.g. "2020", "Q1", "v1.0") rendered as part of the artwork. Keep labels minimal — just dates or short anchors, not descriptions.++## Fewshot prompt snippets++**Snippet A — vector-illustration + cool-corporate, horizontal 5-milestone timeline, text_policy: none, 1200×500**++> Clean flat vector illustration timeline banner. A thin horizontal axis line in primary deep navy `#1E3A5F` runs across the canvas at mid-height. Five circular milestone markers are evenly spaced along the axis — each marker filled with the primary navy and a 2px outline. The third milestone (center) is highlighted with an accent gold `#D4AF37` ring around it (under 5% accent area). Above each marker is a small simple iconic symbol — a seed, a sprout, a plant, a tree, a forest — telling a growth sequence. Below each marker, a thin vertical tick mark drops to the axis. Background is calm secondary light gray `#F8F9FA`. Composed for a 1200×500 hero banner with 12% inner padding above and below the axis. NO text, dates, or labels — SVG labels added externally. Color values are rendering guidance only.++**Snippet B — editorial + editorial-classic, vertical 4-milestone history, text_policy: embedded, 500×800**++> Magazine-style editorial timeline, vertical orientation. A thin vertical axis rule in primary deep navy `#0F2C4C` runs down the canvas, slightly offset to the left of center. Four small circular milestone markers along the axis at equal intervals. Each milestone has a short hand-lettered English year label (e.g. "1980", "2000", "2010", "2020") rendered to the left of the marker in confident editorial type — short numeric labels only, no descriptions. To the right of each marker, one small iconic symbol — a tower, a globe, a phone, a chip — in primary navy with subtle 8% drop shadow. Background is warm secondary cream `#FAF7F2` with subtle paper grain at 8% opacity. Accent burnt orange `#C2410C` appears only on the third milestone's marker as a small emphasis (under 5%). Composed as a 500×800 vertical block with 14% inner padding. English numeric labels only (no Chinese characters). Color values are rendering guidance only.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Axis line missing or unclear | Axis rule too weak | "Clear continuous axis line connecting all milestones, uniform stroke weight" |+| Milestones unevenly spaced | Spacing rule omitted | "Milestones evenly spaced along the axis" |+| Direction ambiguous | Direction not specified | "Time progresses left-to-right (or top-to-bottom)" |+| Iconic clutter | Icons too detailed | "Each milestone has one simple iconic symbol — recognizable at small size" |+| Date labels garbled in embedded | Long or CJK dates | Use short English numeric labels only ("2020", "Q1") |++## When to switch away from timeline++- If progression has process steps with arrows → `flowchart`+- If parallel zones without chronology → `infographic`+- If central concept with related ideas → `framework`+- If atmospheric history scene → `scene`diff --git a/skills/ppt-master/references/image-type-templates/typography.md b/skills/ppt-master/references/image-type-templates/typography.mdnew file mode 100644index 00000000..29f28c05--- /dev/null+++ b/skills/ppt-master/references/image-type-templates/typography.md@@ -0,0 +1,97 @@+# Type: typography++A large headline, number, or single word as the primary visual. The text itself is the image. Used for big-stat pages ("$2.3M"), slogan pages ("MOVE FAST"), chapter openers, hero quotes, signature numbers in consulting decks.++> **What typography means inside a PPT block**: the image's primary content is a piece of text rendered as art. Unlike all other types where text is forbidden or minimal, typography **requires** text — and that text is the visual anchor.++## Composition skeleton++```+ ┌────────────────────────────────────┐+ │ │+ │ ┌─────────────┐ │+ │ │ │ │+ │ │ $2.3M │ ← The │+ │ │ │ text │+ │ └─────────────┘ IS the │+ │ image │+ │ small supporting visual │+ │ │+ └────────────────────────────────────┘+```++| LAYOUT | Large text element occupying 40-60% of canvas height, centered or rule-of-thirds positioned |+| ELEMENTS | The text + minimal supporting visual context (small icon, geometric anchor, accent line). Supporting elements <25% of weight |+| NEGATIVE SPACE | Generous around the text — at least 20% padding |+| TEXT CHARACTER | Rendered with intention — confident weight, deliberate spacing, may have texture/style matching deck rendering |++## Critical: text accuracy++Image models have **variable accuracy on text rendering**:++- **English short text (1-5 characters / one short word)**: most modern models render correctly most of the time+- **English longer text (sentences)**: high failure rate (typos, glyph errors)+- **Numbers / symbols**: variable, often fail at typography scale+- **Chinese / Japanese / Korean characters**: most models fail consistently++**For typography type, prefer**:+- A short English word (1-2 words max)+- A simple number ("100", "5x", "$50M") — verify after generation+- A simple symbol or letter ("∞", "?", "A")++**Avoid for typography type**:+- Long quotes / sentences (use SVG text instead)+- Chinese/CJK characters (model failure expected)+- Complex symbols or composite text++When the desired headline is long or CJK: switch to `background` type and overlay the headline as SVG text.++## Container sizing for local PPT inserts++| Use | Canvas | Aspect | Padding |+|---|---|---|---|+| Full-bleed big-stat page | 1280×720 | 16:9 | 20% padding around text |+| Half-page stat block | 600×600 | 1:1 | 20% |+| Hero slogan banner | 1200×500 | 2.4:1 | 18% |+| Square emphasis | 700×700 | 1:1 | 20% |++## Text-policy variants++### `text_policy: embedded` (required)++typography type is the **one type where embedded text is the entire point**. Always use `text_policy: embedded`.++Sample fragment:++> The image's central content is the hand-lettered (or appropriately styled) word "GROWTH" — rendered as a large confident headline occupying about 50% of the canvas height. Text is in English only (most models render CJK characters poorly). No other text or labels in the image — just the single headline word.++### `text_policy: none` (essentially never)++If text_policy is none, this isn't typography — switch to `background` or `hero`.++## Fewshot prompt snippets++**Snippet A — ink-notes + mono-ink big-number stat, text_policy: embedded, 800×500**++> Professional hand-drawn visual-note style on pure white background. The image's central content is the hand-lettered number "100x" — rendered in bold confident ink strokes occupying about 50% of the canvas height, centered with deliberate slight wobble characteristic of hand-lettering. Text is in English/Latin characters only. Beneath the number, a thin hand-drawn underline in ink. To the side of the number, one small hand-drawn doodle decoration — a star or upward arrow — adds visual rhythm. Accent coral `#E8655A` (from the deck's accent) appears only as a tiny emphasis dot above the number's exclamation, totaling under 4% of canvas. Background is pure white `#FFFFFF`. Composed as an 800×500 typography block with 20% padding around the number. No other text or labels in the image — just the "100x" headline and the small doodle.++**Snippet B — vector-illustration + cool-corporate slogan banner, text_policy: embedded, 1200×500**++> Clean flat vector illustration banner. The image's central content is the bold word "SCALE" — rendered as a large geometric block-letter headline in primary deep navy `#1E3A5F`, occupying about 45% of the canvas height, centered. Letters have crisp vector edges (sans-serif geometric character). Beneath the word, a thin accent gold `#D4AF37` horizontal rule (about 60% of word width). Background is calm secondary light gray `#F8F9FA`. No supporting visuals beyond the rule. Composed as a 1200×500 hero typography banner with 18% padding. Text is English only (5 characters). Color values are rendering guidance — do not paint HEX codes or color names as additional text.++## Common failure modes++| Symptom | Cause | Fix |+|---|---|---|+| Typo / garbled letters | Word too long, or model unreliable | Shorten to 1-2 short words; verify after generation |+| Multiple text elements | "Just one headline" not specified | Reaffirm "only the single headline word — no additional text, no labels, no captions" |+| Chinese characters garbled | CJK requested | Switch to English keyword or use `background` + SVG text overlay |+| Text too small | Size rule omitted | Restate "headline text occupies 40-60% of canvas height" |+| Decorative elements distract | Supporting visuals too prominent | Reaffirm "supporting visuals minimal, under 25% of canvas weight" |++## When to switch away from typography++- If text is long / CJK → use `background` type + SVG text overlay+- If image is a dominant subject (not text) → `hero`+- If pure atmosphere → `background`+- If multiple labeled zones → `infographic`