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
docs(ai-image): two-layer text_policy + subject-domain prompt depth
hugohe381d5872cbcb5
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex f0e6ed21..49748a96 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -221,6 +221,23 @@ Example opening for a triptych hero:>> 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.+### 4.2 Prompt depth — expand for subject-domain accuracy++**Hard rule**: For images whose deck purpose calls for subject-domain accuracy (scientific figures, academic paper figures, engineering schematics, medical / legal / regulated content), expand the prompt without budget ceiling — 500-1000+ words is normal. The §4 word budget (150-300) is the routine-illustration default, not a cap.++**Forbidden — pre-emptive shortening**: never trim a subject-domain prompt to fit §4's budget. Name the field's visual conventions explicitly in the prompt.++**Detail to name in the prompt** (illustrative, not an enumeration to match):++| Domain | Conventions to spell out |+|---|---|+| chemistry / materials | IUPAC atom colors, bond conventions, lattice type, Å / ps units, subplot labeling (A / B / C circles), view angle |+| biology | cell compartment colors, scale bars, organelle conventions, staining palette |+| physics | axis labels with proper symbols, signature curve shapes, unit annotations, peak labeling format |+| engineering | schematic notation, dimension callouts, section-cut conventions |++**When uncertain about field conventions**: read `sources/` before drafting the prompt.+---## 5. Global Hard Rules@@ -243,31 +260,25 @@ When the image contains people:Exception: when the chosen rendering is `corporate-photo`, photorealism is intentional — replace the above with: `Diverse, professionally attired subjects. Editorial photography style, natural composition`.-### 5.3 Text policy — none vs embedded+### 5.3 Text policy — two-layer ownership-| `text_policy` | Prompt cue |-|---|---|-| `none` | "NO text of any kind anywhere in the image — no letters, numbers, signs, watermarks, labels, or written symbols." |-| `embedded` | Describe the text directly inside the visual scene: the word(s), how they're rendered (decorative lettering / designed title / hand-lettered keyword), and the artistic treatment. Examples below. |+Every AI-image page carries text in two layers:-**When to pick `embedded` — the edit-stability test**+| Layer | Owned by | Examples |+|---|---|---|+| Layer 1 (image-owned) | the prompt — baked into the raster | figure-internal annotations (axis labels, A / B / C markers, units, scale bars, panel labels); hero typographic or decorative lettering that *is* the visual |+| Layer 2 (SVG-owned) | `<text>` overlay — fully editable | page-level chrome (title, navigation, footer, body bullets, conclusion callout); readable copy, captions |-Before adding any word to the image, ask: *will this word ever need to be changed?* If yes, it belongs in SVG, not the image. The bar is high — in-image text is for words that are part of the visual itself.+`text_policy` controls only Layer 1. AI judges per image; no global default bias.-| Page situation | Recommended approach |+| `text_policy` | Prompt cue ||---|---|-| **hero_page** — cover, chapter divider, section opener | **Two-layer**: 1-3 high-impact visual keywords go *in* the image (`embedded`); subtitle, date, author, organization, edition, body intro stay on the SVG overlay. **Do not** put the full title block (main + subtitle + author + date) into the image — any later wording change forces an image regen. |-| **local image — infographic / framework / flowchart / matrix / cycle / comparison** | `none` — labels live as SVG text so they stay editable. The image carries the structure; SVG carries the words. |-| **local image — decorative background / scene / portrait** | `none` by default. Use `embedded` only if a decorative word *is* the visual (e.g. a giant "GROWTH" lettering as wall art). |-| **Poster / standalone marketing-style page** | `embedded` allowed for the visual core word; auxiliary copy still SVG. |--The principle in one line: **the image gets the unchanging visual keywords; SVG gets everything readable that might be reworded**.+| `none` | "NO text of any kind anywhere in the image — no letters, numbers, signs, watermarks, labels, or written symbols." |+| `embedded` | Describe the Layer 1 text directly inside the visual scene: the word(s), how they're rendered, and the artistic treatment. |-**Prompt phrasing examples for embedded text** (not an exhaustive list):+**Hard rule — cross-cutting**: Layer 2 chrome stays SVG regardless of `text_policy`. Never bake the deck title, navigation, footer, body bullets, or conclusion callout into the image, even when `embedded`.-- Decorative: "large 'GROWTH' lettering as a background element, 3D extruded retro chrome style"-- Designed title: "main title 'Q3 STRATEGY' typeset in clean geometric sans-serif, centered"-- Hand-lettered set: "small hand-lettered annotations 'fast', 'cheap', 'good' woven into the sketch"+**Forbidden — text that may be reworded**: any word that may later change belongs in Layer 2, not Layer 1. Layer 1 is for stable visual identifiers and designed lettering that is part of the image itself.**Font choice for in-image text — free description, with the deck typography as one optional reference**@@ -365,7 +376,7 @@ Write `project/images/image_prompts.json` with this shape:| `items[].filename` | yes | `§VIII` resource list | Output filename with extension || `items[].type` | conditional | Step 3 per-image (only when `page_role: local`) | One of 11 internal-composition types: `infographic`, `flowchart`, `framework`, `matrix`, `cycle`, `funnel`, `pyramid`, `comparison`, `timeline`, `map`, `scene`. **Omit `type` entirely when `page_role: hero_page`** — the composition comes from §4.1 primitives written directly into the prompt, not from a type file. || `items[].page_role` | yes | Step 3 per-image | `local` (default — region block on SVG page) or `hero_page` (image is page's main voice; SVG overlay minimal or empty) |-| `items[].text_policy` | yes | Step 3 per-image | `none` (default — no text in image) or `embedded` (image contains decorative lettering, designed title, or hand-lettered keywords) |+| `items[].text_policy` | yes | Step 3 per-image | `none` (image carries no text — explicit visual rule) or `embedded` (image contains decorative lettering, designed title, hand-lettered keywords, or stable visual identifiers like axis labels / subplot letters / unit symbols). AI judges per image; no global default bias — see §5.3. || `items[].aspect_ratio` | yes | Container sizing | Passed to `image_gen.py --aspect_ratio` || `items[].prompt` | yes | §4 assembly | The full assembled paragraph || `items[].image_size` | no | Container sizing | `512px` / `1K` / `2K` / `4K` |diff --git a/skills/ppt-master/references/image-layout-patterns.md b/skills/ppt-master/references/image-layout-patterns.mdindex 30f7b530..e243cc36 100644--- a/skills/ppt-master/references/image-layout-patterns.md+++ b/skills/ppt-master/references/image-layout-patterns.md@@ -174,7 +174,7 @@ Stack any of these freely on top of a Primary structure. Multiple Modifiers per64. **Image with embedded text rendered by the AI** — text becomes part of the artwork: decorative lettering, designed title, hand-lettered keyword. Prompt with explicit text content. Reliable only for **short English**. Chinese characters, long phrases, and digits regularly come back malformed and cannot be edited. Anything that must be correct or editable goes in the SVG `<text>` layer.-65. **Image with NO text — labels added as native SVG** — generate the image with explicit "no text, no letters, no numbers, no signs" instruction (`text_policy: none`), then place all labels as `<text>` overlays. Default safe path for any deck with Chinese, data, or editable copy.+65. **Image with NO text — labels added as native SVG** — generate the image with explicit "no text, no letters, no numbers, no signs" instruction (`text_policy: none`), then place all labels as `<text>` overlays. The right call when labels are CJK, will be reworded, or carry data that must stay editable — pair with `#64` when stable visual identifiers (axis labels, subplot letters, unit symbols) belong inside the image instead.66. **Image fading into the solid background** — soften the image's edge into the deck's background color via a `<linearGradient>` overlay whose end-stop matches the background hex exactly. The image's rectangular boundary disappears, producing seamless integration.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex e49257f3..8ee66868 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -320,6 +320,12 @@ After the candidates, append one line:After the user picks a candidate (or supplies a custom variant), proceed to "Recording the lock" below.+#### Prompt depth for §VIII rows++**Hard rule**: When §VIII contains paper-figure or subject-domain rows (scientific subjects, specialized fields, regulated content), each row's `generation description` follows [`image-generator.md`](./image-generator.md) §4.2 Prompt depth — expand to the depth the subject demands; 500-1000+ words is normal.++**Forbidden — generic shortening**: never drop a paper-figure row's prompt to a 50-word generic illustration brief.+---#### Catalog reference (for candidate construction)diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex b00d6c17..9a513cf7 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -254,10 +254,10 @@ Catalog read: 71 templates- **Existing** — user-supplied, place in `images/`- **Placeholder** — not yet processed, use dashed border in SVG-**text_policy** (`ai` rows only; leave blank for default):+**text_policy** (`ai` rows only; AI judges per row, no global default bias):-- *blank / `none`* — image carries no text; SVG overlays labels-- `embedded` — image contains in-artwork text: decorative lettering, a designed title, or hand-lettered keywords. Body copy / data points / long quotes never go inside the image regardless. English text renders most reliably; CJK characters fail in most models+- `none` — image carries no text; SVG overlays all labels+- `embedded` — image contains in-artwork text: decorative lettering, a designed title, hand-lettered keywords, or stable visual identifiers (axis labels, subplot letters, unit symbols). Body copy / data points / long quotes never go inside the image regardless. English text renders most reliably; CJK characters fail in most models**page_role** (`ai` rows only; leave blank for default):