[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ATYWQ4CB2F7HWV2Y4D047T":3,"skill-same:01M7ATYWQ4CB2F7HWV2Y4D047T":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7ATYWQ4CB2F7HWV2Y4D047T","officecli-pptx",null,"Use this skill any time a .pptx file is involved -- as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file; editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions 'deck', 'slides', 'presentation', 'pitch', or references a .pptx filename.","Dhanuzh\u002FDCode-Core","Dhanuzh","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F100478485?v=4","01M7ATTA57GQADD12J7ADW8ZJ3","Dhanush","01M7ATTA5VDZ604WKT0CGNEE7R",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fofficecli-pptx\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: officecli-pptx\ndescription: \"Use this skill any time a .pptx file is involved -- as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file; editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions 'deck', 'slides', 'presentation', 'pitch', or references a .pptx filename.\"\n---\n\n> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS \u002F Linux** (bash\u002Fzsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool\u002FCLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running:\n>\n> | bash (macOS \u002F Linux) | PowerShell (Windows) |\n> | --- | --- |\n> | `a && b` | run as two steps, or `a; if ($?) { b }` |\n> | `cat \u003C\u003C'EOF' \\| tool …` (heredoc) | write the text to a temp file, then pipe\u002Fpass that file to the tool |\n> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` |\n> | `cmd > \u002Fdev\u002Fnull` | `cmd > $null` |\n> | `… \\| grep PAT` | `… \\| Select-String PAT` |\n> | `… \\| jq …` | `… \\| ConvertFrom-Json`, then read the fields |\n> | `python3 x.py` | `python x.py` (or `py x.py`) |\n> | `~\u002Fdir`, `\u002Ftmp` | `$env:USERPROFILE\\dir`, `$env:TEMP` |\n> | `cp` \u002F `mkdir -p` \u002F `rm -rf` | `Copy-Item` \u002F `New-Item -ItemType Directory -Force` \u002F `Remove-Item -Recurse -Force` |\n>\n> If a command has no obvious Windows equivalent, prefer the built-in file\u002FHTTP tools over raw shell.\n\n# OfficeCLI PPTX Skill\n\n## Setup\n\nIf `officecli` is missing:\n\n- **macOS \u002F Linux**: `curl -fsSL https:\u002F\u002Fd.officecli.ai\u002Finstall.sh | bash`\n- **Windows (PowerShell)**: `irm https:\u002F\u002Fd.officecli.ai\u002Finstall.ps1 | iex`\n\nVerify with `officecli --version` (open a new terminal if PATH hasn't picked up). If install fails, download a binary from https:\u002F\u002Fgithub.com\u002FiOfficeAI\u002FOfficeCLI\u002Freleases.\n\n## ⚠️ Help-First Rule\n\n**This skill teaches what good slides look like, not every command flag. When a property name, enum value, or alias is uncertain, consult help BEFORE guessing.**\n\n```bash\nofficecli help pptx                         # List all pptx elements\nofficecli help pptx \u003Celement>               # Full element schema (e.g. shape, chart, animation, connector, zoom, group)\nofficecli help pptx \u003Cverb> \u003Celement>        # Verb-scoped (e.g. add shape, set slide)\nofficecli help pptx \u003Celement> --json        # Machine-readable schema\n```\n\nHelp reflects the installed CLI version. When skill and help disagree, **help is authoritative**. Triggers to run help immediately: `UNSUPPORTED props:` warning, unknown animation preset, `connector.shape=` enum drifts, prop-vs-alias (`lineWidth` vs `line.width`, `color` vs `font.color`).\n\n## Shell & Execution Discipline\n\n**Shell quoting (zsh \u002F bash).** ALWAYS quote element paths (`\"\u002Fslide[1]\u002F...\"`) — zsh globs unquoted `[1]` to `no matches found`. Escaping happens at three layers — keep them separate (the CLI handles the second for you):\n\n1. **Shell.** `$` in a value still belongs to the shell — single-quote the whole value: `--prop text='$15M'`. Double-quoted `\"$15M\"` gets expanded to `M`. The CLI does NOT unescape `\\$` for you.\n2. **CLI (`text=`).** The two-char escapes `\\n` and `\\t` ARE interpreted, consistently across pptx \u002F docx \u002F xlsx — `\\n` is a line \u002F paragraph break, `\\t` is a tab. To produce a literal backslash-n in text, double it (`\\\\n`); this is rarely what you want.\n3. **JSON (batch).** Real newlines \u002F tabs can also be passed as `\"\\n\"` \u002F `\"\\t\"` inside a `\u003C\u003C'EOF'` heredoc; both forms produce the same result.\n\nIf in doubt, `view text` after writing and compare character-for-character.\n\n**Incremental execution.** One command → check exit code → continue. A 50-command script that fails at command 3 cascades silently. After any structural op (new slide, chart, animation, connector) run `get` before stacking more.\n\n## Requirements for Outputs\n\nThese are the deliverable standards every deck MUST meet. Violating any one = not done, regardless of content quality.\n\n### All decks\n\n**One idea per slide.** If a slide needs a second title to explain what it covers, split it. Dense \"everything about X\" slides lose the audience inside 3 seconds. Use a section divider to group related one-idea slides, not a mega-slide.\n\n**Explicit type hierarchy — do NOT rely on theme defaults.** Theme defaults drift between masters. Set sizes explicitly on every text shape.\n\n| Element | Minimum | Typical | Min shape height |\n|---|---|---|---|\n| Slide title | **≥ 36pt** bold | 36–44pt | ≥ 2cm |\n| Section \u002F subtitle | ≥ 20pt | 20–24pt | ≥ 1.2cm |\n| Body text | **≥ 18pt** | 18–22pt | ≥ 1cm |\n| Caption \u002F axis label | ≥ 10pt muted | 10–12pt | ≥ 0.6cm |\n\nRule of thumb: **min shape height ≈ font_pt × 0.05cm**. An 18pt sublabel in a 0.8cm-tall box will overflow — `view annotated` catches this.\n\nTitle must be **≥ 2× body size** (36pt over 20pt works; 28pt over 20pt looks timid). Four legit exceptions to body ≥ 18pt: chart axis labels, legends, footer \u002F page number, and ≤ 5-word KPI sublabels (e.g. \"Active users\"). Descriptive sentences must be ≥ 18pt. Left-align body; center only titles and hero numbers. If \"the cards won't fit\", drop cards instead of shrinking font.\n\n**Two fonts max, one palette.** One heading font + one body font (e.g. Georgia + Calibri) — a third *display* face is fine only for big numerals or the cover title, as long as that heading+body pair stays intact. One dominant brand color (60–70% weight) + one supporting + one accent. Never mix 4+ colors in body content. **The palettes and font pairings in Design Principles are a floor, not a menu:** if the user gave brand colors\u002Ffonts or an existing template, match those first; otherwise the named sets are calibrated seeds — blend or diverge freely, as long as the result isn't *worse* than them and still clears the contrast floor.\n\n**Every slide carries a non-text visual — one that informs.** Shape, chart, icon, gradient band that carries meaning, not decoration. A bullet-only deck is interchangeable with a Word doc. Exceptions: literal quote slides, code blocks, a single summary-table slide.\n\n**Less is more — every element earns its place.** The visual rule above guards against bullet-walls; it is not licence to clutter. Don't pad with decorative stats, icons, or filler sections that don't inform (\"data slop\"). If a slide feels empty, fix it with layout and whitespace, not invented content — cut scope rather than bulk it up, and flag a larger addition instead of making it unprompted.\n\n**Speaker notes on every content slide.** `--type notes --prop text=\"...\"`. The speaker needs a script; the audience shouldn't read the slide verbatim.\n\n**Copy reads human, not AI.** Titles orient on content, not punchline. No \"It's not X. It's Y.\", no manufactured tension, no faux-insight (\"The magic moment\"), no one-word drama (\"Momentum.\"). Cut hype adjectives (seamless, robust, game-changing) — let the number carry it.\n\n**Preserve existing templates.** When a file already has a theme and masters, match them. Existing conventions override these guidelines.\n\n### Visual delivery floor (applies to EVERY deck)\n\nBefore declaring done, the per-slide render (see QA) MUST satisfy:\n\n- **No placeholder tokens rendered as content.** `{{name}}`, `$fy$24`, `\u003CTODO>`, `lorem`, `xxxx`, empty `()`\u002F`[]` in chart titles never appear.\n- **No overflow off-edge, no clipped text in shapes.** `view issues` flags both (`shape_off_slide` + a text-fit hint). To fix a clip: grow the box or shorten the value — never trim content to fit.\n- **Cover carries its orienting elements.** Title + subtitle + presenter\u002Fclient + date + a brand band or key-takeaway strap — a title-only cover reads as a stub. Generous whitespace around them is still right; rich ≠ crowded.\n- **Contrast.** `view issues` auto-flags the common case — opaque dark text on a shape's own dark fill (`low_contrast`). It can't see the rest: icon \u002F chart-series fills, scheme\u002Finherited colors, or text over a *separate* background shape. So on any fill with brightness \u003C 30% (`1E2761`, `36454F`, deep forest \u002F berry \u002F cherry), still confirm every body run, card body, chart series, and icon is `FFFFFF` or brightness > 80% — mid-gray (`6B7B8D` ≈ 44%) reads on a laptop and vanishes on projection. Spot-check via `view html` after the dark-fill pass.\n\nIf any fails, STOP and fix before declaring done.\n\n## Design Principles\n\nA deck is not a document. The audience has 3 seconds to get each slide. Before adding anything, ask: \"If the audience reads only the biggest element and glances once, do they get the point?\" If they have to read the bullets, the biggest element is wrong.\n\n### Grid, margins, negative space\n\nStandard widescreen is **33.87 × 19.05cm**. Treat it as a 12-column grid internally:\n\n- **Edge margin ≥ 1.27cm** (0.5\") on all sides.\n- **Inter-block gap ≥ 0.76cm** (0.3\") between cards \u002F columns \u002F rows — pick one value (0.76 or 1.27cm) and use it everywhere; mixed gaps look unfinished.\n- **≥ 20% negative space per slide.** Filling every pixel reads as amateur.\n- **Compose, don't web-center.** Whitespace is structural: a slide top-weighted with open space in the lower third is correct composition, not an empty defect. Intentional asymmetry (content left, breathing room right) reads more designed than centering everything — don't fill a gap just because it's there.\n- For card grids: `usable = 33.87 − 2·margin − (N−1)·gap`, then `col_width = usable \u002F N`. Don't hand-pick x coordinates.\n\n### Font pairings\n\nPair by document register, not by novelty. \"Best For\" is a prompt, not a decree; a pairing outside this table is fine if it fits — these 8 are seeds, not the set.\n\n| Header | Body | Best For |\n|---|---|---|\n| Georgia | Calibri | Formal business, finance, executive reports |\n| Arial Black | Arial | Bold marketing, product launches |\n| Calibri | Calibri Light | Clean corporate, minimal design |\n| Cambria | Calibri | Traditional professional, legal, academic |\n| Trebuchet MS | Calibri | Friendly tech, startups, SaaS |\n| Impact | Arial | Bold headlines, event decks, keynotes |\n| Palatino | Garamond | Elegant editorial, luxury, nonprofit |\n| Consolas | Calibri | Developer tools, technical \u002F engineering |\n\nSet both fonts explicitly on every shape (`--prop font=Georgia` on titles, `--prop font=Calibri` on body), not via theme inheritance.\n\n### Color and contrast\n\nThe columns: **Primary** (dominant — 60–70% of weight, the color you see first), **Secondary** (supporting tone), **Accent** (sparing, one-hit emphasis), **Text** (body on light fills), **Muted** (captions \u002F axis labels \u002F footer).\n\n| Theme | Primary | Secondary | Accent | Text | Muted |\n|---|---|---|---|---|---|\n| Coral Energy | `F96167` | `F9E795` | `2F3C7E` | `333333` | `8B7E6A` |\n| Midnight Executive | `1E2761` | `CADCFC` | `FFFFFF` | `333333` | `8899BB` |\n| Forest & Moss | `2C5F2D` | `97BC62` | `F5F5F5` | `2D2D2D` | `6B8E6B` |\n| Charcoal Minimal | `36454F` | `F2F2F2` | `212121` | `333333` | `7A8A94` |\n| Warm Terracotta | `B85042` | `E7E8D1` | `A7BEAE` | `3D2B2B` | `8C7B75` |\n| Berry & Cream | `6D2E46` | `A26769` | `ECE2D0` | `3D2233` | `8C6B7A` |\n| Ocean Gradient | `065A82` | `1C7293` | `21295C` | `2B3A4E` | `6B8FAA` |\n| Teal Trust | `028090` | `00A896` | `02C39A` | `2D3B3B` | `5E8C8C` |\n| Sage Calm | `84B59F` | `69A297` | `50808E` | `2D3D35` | `7A9488` |\n| Cherry Bold | `990011` | `FCF6F5` | `2F3C7E` | `333333` | `8B6B6B` |\n\nPick by topic, not by default — finance reads Midnight Executive, a product launch reads Coral Energy, safety \u002F LOTO reads Cherry Bold. If the closest named theme is not quite right, blend (e.g. Forest primary + gold `D4A843` accent). Use **Text** on light fills, **Muted** for captions \u002F axis \u002F footer, `FFFFFF` or Secondary for body on dark fills.\n\nOn dark backgrounds, text and chart series follow the Hard rules contrast floor above.\n\n### Chart-choice decision table\n\nWrong chart type kills the 3-second test:\n\n| Data shape | Use | Avoid |\n|---|---|---|\n| Category comparison (A vs B vs C) | `column` (vertical) \u002F `bar` (≥ 6 categories, horizontal) | pie (slices merge), line (no time axis) |\n| Time series, 1–3 series | `line` | area (occlusion), bar (implies discrete) |\n| Part-of-whole, 2–5 slices | `pie` \u002F `doughnut` | pie with 8+ slices (unreadable) |\n| Correlation \u002F distribution | `scatter` | line (implies ordering) |\n| Multiple categories × metrics, dense | stacked `column` or heatmap | one chart per metric — consolidate |\n| KPI snapshot (single big number) | **Large-text shape** (60–72pt + ≤ 5-word sublabel), NOT a chart | gauge chart, tiny bar |\n\nRule of thumb: if > 3 series and > 8 categories, split into two charts or switch to a table.\n\n### Animation\n\nUse as much or as little as the brand and content call for — a formal finance deck trends to near-zero, a product launch can be more expressive. Animation is a tool, not décor. Three floors keep it from hurting the deck (none caps how much you use):\n\n- **Purposeful** — each one reveals or emphasizes (progressive bullet reveal, a build-up chart), never decorates. If it doesn't aid comprehension, cut it.\n- **Degrades gracefully** — pptx animation renders inconsistently across viewers (Keynote \u002F Slides \u002F web \u002F mobile) and may not play at all, so every slide must read correctly as a *static* frame. Never hide essential content behind a reveal.\n- **Verify live** — animation is runtime-only; `view html` and screenshots can't see it, so confirm in a real presentation viewer before shipping.\n\nTaste steer (not a ban): `fade` \u002F `appear` \u002F a single `zoom-entrance` with snappy durations (~hundreds of ms) fit most decks; `bounce` \u002F `swivel` \u002F `spin` \u002F `fly-from-edge` \u002F dense multi-object choreography usually read amateur — reach for them only when the brand is deliberately playful.\n\n### Layout patterns & data display\n\nVary layout across slides — repeating the same pattern makes every slide feel identical. These are common building blocks, not the full set — pick one per slide, or build a layout outside the table when the content calls for it:\n\n| Pattern | When to use | Key measurement |\n|---|---|---|\n| **Two-column** (text left, visual right) | Concept + evidence; feature + screenshot | Each col ≈ 14-15cm; gap 1cm |\n| **Icon rows** (icon in filled circle + bold header + description) | Feature lists, benefits, team roles | Icon circle 1.5-2cm; 3-4 rows max |\n| **2×2 or 2×3 grid** (card tiles) | Quadrant analysis, SWOT, option comparison | Gap ≥ 0.76cm; consistent card height |\n| **Half-bleed image** (full left or right half, content overlay on other side) | Hero moments, case study openers | Image 16-17cm wide; content column ≥ 14cm |\n| **Large stat callout** (60-72pt number + ≤5-word sublabel below) | Single KPI, milestone, market size | Use shape, NOT a chart; sublabel 14-16pt muted |\n\n**Data display quick rules:**\n- Comparison columns (before\u002Fafter, A vs B) beat a table for 2-3 options.\n- Timelines and process flows: numbered step shapes + connectors, not a bullet list.\n\n### Image treatment (only when a slide uses a photo \u002F screenshot \u002F logo)\n\n**Read the image first** (open the file) and choose treatment from what you see — don't place blind from a filename.\n\n- **Full-bleed photo** → size to COVER the region (crop edges), no border.\n- **Screenshot \u002F diagram \u002F logo** → size to FIT (never crop content). A transparent or fit image sits on a contrasting fill — drop a colored rectangle behind it, don't let it float on white.\n- **Text over a photo** → never raw on the image. Put it on a card, or lay a protection scrim between image and text (a dark rectangle at ~50–60% opacity, or a gradient fading from the text edge).\n- Never stretch (distort the aspect ratio); don't overlay text on a busy screenshot.\n- Prefer user-provided images \u002F brand assets; no emoji or self-drawn art unless asked.\n\n### Visual motif commitment\n\nPick ONE distinctive element (rounded image frames, section numbers in filled circles, single-side border band, diagonal accent strips) and carry it to every slide — commit across the whole deck; styling one slide and leaving the rest plain reads as abandoned. A secondary motif is fine only if it doesn't compete with the primary. Declare it in your build plan first: `## Motif: numbered circles in brand color`.\n\n### Visual AI-tells to avoid\n\n- **No decorative underline under slide titles.** A stripe \u002F rule below a heading is the single most common AI-slide tell — use whitespace or a background-color change instead.\n- **No rounded-corner card with a colored left-border accent stripe.** The other classic AI-slide tell — use a solid fill, a top accent band, or whitespace separation instead.\n- **No emoji as iconography** unless the brand uses them — use a shape or a real icon asset.\n\nCopy-level tells live in \"Copy reads human\".\n\n## Common Workflow\n\n1. **Open\u002Fclose mode.** Always `officecli open \u003Cfile>` at start + `officecli close \u003Cfile>` at end. Resident is the default, not an optimization. Use `batch` for repetitive shape grids.\n2. **Orient.** New deck: `officecli create \"$FILE\"`. Existing: `officecli view \"$FILE\" outline` first. Never edit blind.\n3. **Title sequence first (plan, don't build yet).** Before creating any slide or shape, write out the full ordered list of slide titles. If someone reading ONLY the titles can't follow the argument, fix the arc now — cheaper in a list than after 14 slides. Pick ONE title grammar — all topic noun-phrases or all action statements, never a mix — and hold it throughout (see \"Copy reads human\").\n4. **Build in display order.** Add slides in audience-view order: cover → agenda → section-1 divider → section-1 content → section-2 divider → … → closing. `--index` on slide add works, but linear append keeps the build script readable and avoids index-arithmetic bugs. **Before final delivery, confirm slide count + narrative arc match your build plan.** Gate 3's order-sanity check catches cases where the cover ends up as slide 11 of 14 instead of slide 1.\n5. **Incremental per slide.** Create slide + background, then title, then supporting shapes \u002F charts \u002F connectors. Always `layout=blank` for custom designs. After each structural op, `get \u002Fslide[N] --depth 1` to confirm shape IDs.\n6. **Format to spec.** Per the Requirements table; formatting is deliverable, not polish.\n7. **Close + verify.** `officecli close` writes the ZIP. Always open in the target presentation viewer before shipping — chart colors, animations, fonts, and zoom are runtime features `view html` can't render. Full verification in QA below.\n8. **QA — assume there are problems.** Fix-and-verify until a cycle finds zero new issues.\n\n## Quick Start\n\nMinimal viable deck: cover + one content slide + notes. `$FILE` stands in for your filename.\n\n```bash\nFILE=\"deck.pptx\"\nofficecli create \"$FILE\"\nofficecli open \"$FILE\"\n\n# Cover — dark fill, centered title\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761\nofficecli add \"$FILE\" \u002Fslide[1] --type shape --prop text=\"FY26 Strategic Review\" \\\n  --prop x=2cm --prop y=7cm --prop width=29.87cm --prop height=3cm \\\n  --prop font=Georgia --prop size=44 --prop bold=true --prop color=FFFFFF --prop align=center\n\n# Content — white fill, title + body + notes\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=FFFFFF\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop text=\"Revenue grew 18% YoY\" \\\n  --prop x=1.5cm --prop y=1.2cm --prop width=30cm --prop height=2cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop text=\"Enterprise renewals + new EMEA region drove the beat; NRR held at 118%.\" \\\n  --prop x=1.5cm --prop y=4cm --prop width=30cm --prop height=3cm \\\n  --prop font=Calibri --prop size=20 --prop color=333333\nofficecli add \"$FILE\" \u002Fslide[2] --type notes --prop text=\"Lead with the 18% beat, preview EMEA.\"\n\nofficecli close \"$FILE\"\nofficecli validate \"$FILE\"\n```\n\nShape of every build: open → slide+background → title → body → notes → close → validate.\n\n## Reading & Analysis\n\nStart wide, then narrow. `outline` first, `view text` \u002F `get` \u002F `query` once you know where to look.\n\n```bash\nofficecli view \"$FILE\" outline          # slide count + titles\nofficecli view \"$FILE\" annotated        # complete per-slide breakdown with fonts, sizes, tables, charts\nofficecli view \"$FILE\" text --start 1 --end 5   # text dump (includes table cell text)\nofficecli view \"$FILE\" issues           # empty slides, overflow hints\nofficecli view \"$FILE\" stats            # counts + totals (incl. pictures missing alt)\n```\n\n**Inspect one element.** XPath-style paths, 1-based. ALWAYS quote. Prefer `@name=` \u002F `@id=` selectors over positional `[N]` (stable across reorderings). `[last()]` works. Add `--json` for machine output.\n\n```bash\nofficecli get \"$FILE\" \"\u002Fslide[1]\" --depth 1              # shape list with IDs and names\nofficecli get \"$FILE\" \"\u002Fslide[1]\u002Fshape[@name=Title]\"\nofficecli get \"$FILE\" \"\u002Fslide[1]\u002Ftable[1]\" --depth 3     # table rows \u002F cells\n```\n\n**Query across the deck.** CSS-like selectors; operators `=`, `!=`, `~=`, `>=`, `\u003C=`, `[attr]`, `:contains()`, `:no-alt`. `help pptx query` lists queryable element types.\n\n```bash\nofficecli query \"$FILE\" 'shape:contains(\"Revenue\")'\nofficecli query \"$FILE\" 'picture:no-alt'                 # accessibility gap\nofficecli query \"$FILE\" 'shape[fill=1E2761]'             # color match\nofficecli query \"$FILE\" 'shape[width>=10cm]'             # numeric\n```\n\n**`query --json` output schema.** Results wrap in `.data.results[]` — `jq -r '.data.results[0].format.id'`, NOT `.[0].id`. Shape name is `.name`; fill is `.format.fill`; textColor is `.format.textColor`.\n\n**Visual preview (LEAD).**\n\n```bash\nofficecli view \"$FILE\" html                # prints an HTML preview path; Read it for per-slide visual audit (best structural ground truth)\nofficecli view \"$FILE\" svg --start 3 --end 3   # single slide SVG (charts + gradients do NOT render in SVG)\n```\n\n**Reading the output — an expected non-defect:**\n- **`layout=blank` has no title placeholder.** Titles are plain `shape` elements, so `view outline` reporting `(untitled)` is **expected**, not a defect. Use `layout=title` + `placeholder[title]` only when screen-reader outline compatibility matters.\n\n## Creating & Editing\n\nVerbs: `add` \u002F `set` \u002F `remove` \u002F `move` \u002F `swap` \u002F `batch` \u002F `raw-set`. Ninety percent of a deck is slides, shapes, text, a few charts, pictures, connectors.\n\n### Slides and backgrounds\n\nA slide is `\u002Fslide[N]`. Always pass `layout=blank` for custom designs. Background: solid, gradient, or image.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761                 # solid\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop \"background=1E2761-CADCFC-180\"   # gradient (start-end-angle)\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=image:\u002Fpath\u002Fto\u002Fhero.jpg  # image background (LEAD)\n```\n\n### Shapes\n\nA `shape` holds text, fill, border, position, and optional animation \u002F link.\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop name=Title --prop text=\"Key Insight\" \\\n  --prop x=2cm --prop y=2cm --prop width=20cm --prop height=3cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761 --prop fill=none\n```\n\nPositioning is explicit — no layout engine, you own the grid math. `--prop preset=` picks geometry (`rect`, `roundRect`, `ellipse`, `triangle`, `arrow`, `star5`, ...); custom `M...Z` paths are not supported — pick a preset. **Name shapes at creation** (`--prop name=HeroTitle`) and address later with `\"\u002Fslide[N]\u002Fshape[@name=HeroTitle]\"` — names survive z-order \u002F remove-then-add, whereas positional `\u002Fshape[3]` (and even `@id=`) shift. Re-`get --depth 1` after any structural change before using positional indexes.\n\n### Text inside shapes (paragraphs, runs, styling)\n\nA shape has paragraphs (`paragraph[K]`) and runs (`run[K]`). For one-line text, `--prop text=` on the shape is enough; a `\\n` in the text makes a paragraph break, `\\t` a tab (see Shell & Execution Discipline; double `\\\\n` for a literal). `add --type paragraph` takes the same style props as a shape (text, align, bold, italic, size, color, font). For mixed styling *within* a line, append a styled run:\n\n```bash\nofficecli add \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=Card1]\u002Fparagraph[1]\" --type run \\\n  --prop text=\" (inline detail)\" --prop size=14 --prop italic=true --prop color=8899BB\n```\n\n### Charts\n\nPick chart type per the Design Principles chart-choice table. Full prop list (chartType enum, `seriesN.*`, `data=`\u002F`categories=`, axis options): `help pptx add chart`. Typical multi-series with brand colors:\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[3] --type chart --prop chartType=column \\\n  --prop series1.name=Revenue --prop series1.values=\"42,45,48\" --prop series1.color=1E2761 \\\n  --prop series2.name=Growth  --prop series2.values=\"2,7,7\"    --prop series2.color=CADCFC \\\n  --prop categories=\"Q1,Q2,Q3\" \\\n  --prop x=2cm --prop y=4cm --prop width=20cm --prop height=10cm\n```\n\nGotchas: (1) chart titles with `()`, `[]`, `TBD` ship as literal text. (2) some viewers normalize chart colors to theme defaults — verify in the target viewer. Series can be added after creation (`add --type series`).\n\n### Pictures\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[4] --type picture --prop src=hero.jpg \\\n  --prop x=1cm --prop y=1cm --prop width=32cm --prop height=18cm \\\n  --prop alt=\"Product hero, gradient lit from right\"\n```\n\nConfirm with `officecli query \"$FILE\" 'picture:no-alt'` — must be empty before delivery.\n\n### Connectors (LEAD — flowcharts \u002F decision trees first-class)\n\nDraws a line between two shapes or free coordinates. Full prop \u002F enum reference (`shape`, `headEnd`\u002F`tailEnd` values, `from`\u002F`to` ref forms): `help pptx add connector`.\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[5] --type connector \\\n  --prop \"from=\u002Fslide[5]\u002Fshape[@name=BoxA]\" --prop \"to=\u002Fslide[5]\u002Fshape[@name=BoxB]\" \\\n  --prop shape=elbow --prop color=333333 --prop tailEnd=triangle\n```\n\n**Every flow connector needs an arrowhead.** Without one, `bentConnector3` renders as a directionless line. `preset=rightArrow` overlay only works for horizontal flows; diamonds \u002F decision trees with diverging edges need `tailEnd=`.\n\n### Animations (LEAD)\n\nUse per the Animation floors above (purposeful, degrades gracefully, verify live). Preset names + duration syntax: `help pptx animation`.\n\n```bash\nofficecli set \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=HeroCard]\" --prop animation=fade-entrance-400\nofficecli set \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=HeroCard]\" --prop animation=none    # clear all\n```\n\n### Hyperlinks, tooltips, slide-jump\n\n`--prop link=slide[N]` for an in-deck jump (1-based; target slide must exist), `link=nextslide` \u002F `firstslide` \u002F `lastslide` \u002F `previousslide` \u002F `endshow` for named navigation, `link=https:\u002F\u002F...` for a URL, `--prop tooltip=\"...\"` for hover text.\n\n### Tables, placeholders, groups, zoom — one-liners\n\n- **Tables** — `--type table --prop rows=N --prop cols=M`. Row-level `set` supports `height` and `c1\u002Fc2\u002Fc3` (seed cell text). Header-row styling is table-level (`firstRow=true` \u002F `headerFill=`), not a row prop. Cell formatting lives on the cell paragraph \u002F run. Populate rows BEFORE setting table-level font (font cascade gets reset by row ops).\n- **Placeholders** — `\"\u002Fslide[N]\u002Fplaceholder[title]\"` \u002F `placeholder[body]`. Available only when the slide uses a layout with placeholders (not `layout=blank`).\n- **Groups** (LEAD) — address children via `\"\u002Fslide[N]\u002Fgroup[@name=G]\u002Fshape[1]\"`. Survives reordering better than positional indexes.\n- **Zoom slide** (LEAD) — `--type zoom --prop target=N` (one link per target; alias `slide`). Emit N separate zoom shapes for a multi-target nav hub. Zoom is a runtime feature — `view html` shows the static geometry; the zoom interaction runs only in a live presentation viewer.\n- **Slide comments** — reviewer annotations anchored at `\u002Fslide[N]\u002Fcomment[M]`. Full lifecycle (`add \u002F set \u002F get \u002F query \u002F remove`). Props: `text`, `author`, `initials` (auto-derived), `date` (ISO 8601, defaults to UtcNow), `x` \u002F `y` (length anchor).\n  ```bash\n  officecli add \"$FILE\" \"\u002Fslide[2]\" --type comment --prop author=\"Alice\" --prop text=\"Tighten this bullet\" --prop x=20cm --prop y=3cm\n  officecli query \"$FILE\" 'comment' --json | jq '.data.results | length'   # count all review comments\n  officecli remove \"$FILE\" \"\u002Fslide[2]\u002Fcomment[1]\"                           # resolve after addressing\n  ```\n\n### Deck-level recipes\n\nPatterns not obvious from the primitives. Each gives the **visual outcome** first, then a runnable block. `$FILE` = your filename. Use `\u002Fslide[last()]` to address the slide you just added. The recipes demonstrate **structure and coordinate math** — swap in the palette \u002F fonts you chose for this topic; the navy `1E2761` + Georgia is just the example's theme, not a house style to copy verbatim.\n\n**Z-order.** Later-added shapes are on top. Add background decoration FIRST, titles LAST. To fix after the fact: `--prop zorder=back\u002Ffront` (renumbers siblings — re-`get --depth 1` before stacking more).\n\n#### (a) Cover (and section divider)\n\n**Visual outcome.** Dark navy fill, centered 44pt title, 18pt ice-blue meta line.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Strategic Growth Review\" \\\n  --prop x=2cm --prop y=7cm --prop width=29.87cm --prop height=3cm \\\n  --prop font=Georgia --prop size=44 --prop bold=true --prop color=FFFFFF --prop align=center\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Prepared for Acme Leadership — FY26 Outlook\" \\\n  --prop x=2cm --prop y=11cm --prop width=29.87cm --prop height=1.2cm \\\n  --prop font=Calibri --prop size=18 --prop color=CADCFC --prop align=center\n```\n\n**Section divider** = same cover, plus a giant translucent number (`size=120`, `opacity=0.15`) added FIRST so it sits behind the section title.\n\n#### (b) Data slide (chart + commentary block)\n\n**Visual outcome.** Left two-thirds: column chart with brand series colors. Right one-third: \"Key Insight\" card with 20pt heading + 18pt body — audience reads the takeaway before parsing the bars.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=FFFFFF\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"FY26 Revenue Beat Plan by 18%\" \\\n  --prop x=1.5cm --prop y=1cm --prop width=30cm --prop height=1.8cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761\n\n# Chart — left 2\u002F3 (single-quote the title because of `$`)\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type chart --prop chartType=column \\\n  --prop series1.name=Actual --prop series1.values=\"42,45,48,55\" --prop series1.color=1E2761 \\\n  --prop series2.name=Plan --prop series2.values=\"40,42,45,48\" --prop series2.color=CADCFC \\\n  --prop categories=\"Q1,Q2,Q3,Q4\" --prop x=1.5cm --prop y=3.5cm --prop width=20cm --prop height=14cm --prop title='FY26 Revenue ($M)'\n\n# Commentary card — right 1\u002F3: background + heading + body\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop preset=roundRect --prop fill=F5F7FA --prop line=none \\\n  --prop x=22.5cm --prop y=3.5cm --prop width=9.8cm --prop height=14cm\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Key Insight\" \\\n  --prop x=23cm --prop y=4cm --prop width=9cm --prop height=1.2cm \\\n  --prop font=Georgia --prop size=20 --prop bold=true --prop color=1E2761\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"EMEA launch + NRR at 118% drove 12pp of the 18pp beat.\" \\\n  --prop x=23cm --prop y=5.5cm --prop width=9cm --prop height=11cm \\\n  --prop font=Calibri --prop size=18 --prop color=333333\n```\n\n#### (c) Flowchart \u002F process diagram (boxes + connectors)\n\n**Visual outcome.** Four rounded boxes across at y=8cm, each 6×3cm, alternating navy\u002Ficeblue, joined by elbow connectors with triangle arrowheads.\n\nGrid math (4 boxes, 33.87cm slide, 1.5cm margins): `gap = (33.87 − 3 − 24) \u002F 3 = 2.29cm`. x-positions: `1.5, 9.79, 18.08, 26.37`.\n\nEach box carries its own label via `valign=middle` (no separate overlay shape needed). Use `batch` heredoc for portable coordinate arithmetic — no `bc`, no bash arrays.\n\n```bash\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step1\",\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"1.5cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 1\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step2\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"9.79cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 2\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step3\",\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"18.08cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 3\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step4\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"26.37cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 4\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}}\n]\nEOF\n\n# Connector pattern — reuse for any box-to-box graph.\nfor pair in \"Step1 Step2\" \"Step2 Step3\" \"Step3 Step4\"; do\n  A=${pair% *}; B=${pair#* }\n  officecli add \"$FILE\" \"\u002Fslide[$SLIDE]\" --type connector \\\n    --prop \"from=\u002Fslide[$SLIDE]\u002Fshape[@name=$A]\" \\\n    --prop \"to=\u002Fslide[$SLIDE]\u002Fshape[@name=$B]\" \\\n    --prop shape=elbow --prop color=333333 --prop tailEnd=triangle\ndone\n```\n\n`shape=elbow` is canonical (`bentConnector2` \u002F `bentConnector3` also accepted).\n\n#### (d) Multi-slide deck skeletons\n\nNo code block — it's a rhythm. The sequences below are **illustrations of one working cadence (alternating dark dividers with white content), not required running orders** — derive your actual arc from the content first (see \"Title sequence first\"), then borrow whatever divider\u002Fcontent rhythm fits:\n\n- **10-slide review:** Cover · Agenda · 3 KPI · Div01 · Chart · Chart · Div02 · Flow · Timeline · Close\n- **20-slide pitch:** same rhythm × 2, sectioned Problem · Solution · Market · Product · Traction · Model · Team · Financials · Ask\n- Every divider must appear **before** its section content (Gate 3 order sanity)\n- Cover\u002Fdivider = (a); chart pages = (b); process pages = (c); KPI pages = (e); decision pages = (f)\n\n#### (e) KPI callouts — giant-number card grid\n\n**Visual outcome.** Three or four giant numbers across a row; each card = unit sublabel + small percent-change chip + one-line takeaway. The single most common exec-deck element.\n\n**Sizing rule.** 60pt Georgia bold fits ~5 chars in a 9.78cm card (`$84.2`, `118%`, `24.5`). For longer values (`$84.2M`), split: `$84.2` as the big number, `USD millions` as the sublabel — never shrink the font to chase a unit suffix, it just wraps.\n\nGrid math (3 cards, 1.5cm margins, 0.76cm gap): `col_width = (33.87 − 3 − 1.52) \u002F 3 = 9.78cm`. x-positions: `1.5, 12.04, 22.58`. Use accent color on a single \"watch\" card so risk reads in one second.\n\n```bash\n# Two cards: navy standard + terracotta watch. Each = bg + big number + sublabel + chip.\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"1.5cm\",\"y\":\"4cm\",\"width\":\"9.78cm\",\"height\":\"7cm\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"84.2\",\"x\":\"1.5cm\",\"y\":\"4.8cm\",\"width\":\"9.78cm\",\"height\":\"2.8cm\",\"font\":\"Georgia\",\"size\":\"60\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"USD millions · ARR\",\"x\":\"1.5cm\",\"y\":\"8cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"color\":\"CADCFC\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"+24% YoY\",\"x\":\"1.5cm\",\"y\":\"9cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"CADCFC\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"preset\":\"roundRect\",\"fill\":\"B85042\",\"line\":\"none\",\"x\":\"22.58cm\",\"y\":\"4cm\",\"width\":\"9.78cm\",\"height\":\"7cm\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"$1.42\",\"x\":\"22.58cm\",\"y\":\"4.8cm\",\"width\":\"9.78cm\",\"height\":\"2.8cm\",\"font\":\"Georgia\",\"size\":\"60\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"CAC payback (yrs)\",\"x\":\"22.58cm\",\"y\":\"8cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"+8% — watch\",\"x\":\"22.58cm\",\"y\":\"9cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}}\n]\nEOF\n```\n\n#### (f) Decision tree — YES\u002FNO branching\n\n**Visual outcome.** Diamond at top-center; YES\u002FNO child boxes diverging left-right; both converge into a shared terminal box. Layout: diamond at `x=13.94, y=2cm, 6×3cm`; YES at `3cm, 7.5cm`; NO at `22.87cm, 7.5cm`; terminal at `13.94cm, 13cm`. Convention: red = stop\u002Fescalate, blue = standard, green = safe terminal. **Every connector needs an arrowhead** — readers misparse direction otherwise.\n\n```bash\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Decide\",\"preset\":\"diamond\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"13.94cm\",\"y\":\"2cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Hazardous energy present?\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"YesBox\",\"preset\":\"roundRect\",\"fill\":\"B85042\",\"line\":\"none\",\"x\":\"3cm\",\"y\":\"7.5cm\",\"width\":\"8cm\",\"height\":\"3cm\",\"text\":\"Lockout + Tagout + Verify\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"NoBox\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"22.87cm\",\"y\":\"7.5cm\",\"width\":\"8cm\",\"height\":\"3cm\",\"text\":\"Proceed with standard PPE\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Done\",\"preset\":\"roundRect\",\"fill\":\"2C5F2D\",\"line\":\"none\",\"x\":\"13.94cm\",\"y\":\"13cm\",\"width\":\"6cm\",\"height\":\"2.5cm\",\"text\":\"Begin service\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}}\n]\nEOF\n```\n\nThen 4 connectors (`Decide→YesBox`, `Decide→NoBox`, `YesBox→Done`, `NoBox→Done`) using the connector loop pattern from (c).\n\n## QA (Required)\n\n**Assume there are problems.** First render is almost never correct. If you found zero issues, you were not looking hard enough.\n\n### Delivery Gate (any failure = REJECT, do NOT deliver)\n\nGates 1–2b are text\u002Fschema-level (cannot see a rendered slide); Gate 3 is the only visual check. Done = every gate PASS **and** Gate 3 loop converged.\n\nEach gate is **run a command, judge its output** — the officecli commands are identical on every OS (macOS \u002F Linux \u002F Windows), so no shell scripting is needed; the judging is yours.\n\n- **Gate 1 — schema.** `officecli validate \"\u003Cfile>\"`. Any schema error → REJECT and fix.\n- **Gate 2 — overflow \u002F format \u002F structure.** `officecli view \"\u003Cfile>\" issues`. If it lists *any* issue (lines tagged `[O1]`, `[C1]`, `[S1]`, …) → REJECT, fix, re-run until clean.\n- **Gate 2b — leftover placeholders.** `officecli view \"\u003Cfile>\" text`, then scan the output for `xxxx`, `lorem` \u002F `ipsum`, `\u003CTODO>`, `placeholder`, \"this slide layout\", or empty `()` \u002F `[]`. Any hit → REJECT.\n\n### Gate 3 — Visual audit (MANDATORY)\n\nPick **one** path:\n\n**Screenshot (default)** — needs image-Read + a headless browser. Screenshot each slide in turn — `officecli view \"\u003Cfile>\" screenshot --page 1 -o slide1.png`, then `--page 2`, … — until the page index runs past the deck (one screenshot = one slide). If it errors on page 1, there's no headless backend → use the fallback below.\n\n**Judge every PNG against the checklist, adversarially** — \"assume problems exist; finding none means you didn't look hard enough.\" Report one `slide N: \u003Cissue>` line per problem, or `PASS`. This step is required however you run it. **If** your harness can spawn a subagent, delegate the judging to a *fresh, independent* one — the agent that built the deck is biased toward \"looks fine\", a separate pair of eyes is more critical — handing it the screenshots + this checklist and the same adversarial framing. No subagent? Do exactly the same yourself.\n\n**Fallback — HTML-text** (no image-Read or no browser): read `view \"$FILE\" html` as text. DOM cannot prove **dark-on-dark \u002F fine overlap \u002F arrowheads \u002F gap-margin metrics \u002F column alignment** — flag these as \"not visually verified\" rather than PASS.\n\n**Optional `--grid N`** — only on user request for layout-rhythm, or when `view outline` shows anomalous layout distribution: `officecli view \"\u003Cfile>\" screenshot --grid 3 -o grid.png`.\n\n**Per-slide checklist (assume issues exist):**\n\n- **overlap** — shapes \u002F charts \u002F giant decorative numbers (01\u002F02\u002F03 100pt+) colliding\n- **text overflow** — clipped at slide or shape boundary (KPI cards, narrow boxes)\n- **narrow text box** — content fits technically but wraps to many short lines (1–2 words each); long sublabel in a 3cm KPI card, body line in a too-tight column\n- **dark-on-dark** — fill brightness \u003C 30% with text\u002Ficon brightness \u003C 80% (incl. dark icons on dark without a contrasting circle)\n- **image treatment** — photo stretched\u002Fdistorted, text raw on a busy image (no card\u002Fscrim), screenshot or logo cropped, transparent image floating on white\n- **missing arrowheads** — flowchart connectors as plain lines\n- **decorative-line \u002F title mismatch** — accent bar sized for one-line title but title wrapped to two (or vice versa)\n- **footer \u002F citation collision** — source line, page number, or footnote touching content above\n- **tight margin \u002F gap** — element within ~0.5\" of slide edge, or two cards within ~0.3\"\n- **uneven gaps** — large empty area on one side, cramped on another (broken rhythm)\n- **column \u002F repeat-element misalignment** — KPI cards \u002F icons off baseline or inconsistent width\n- **order sanity** — sequence matches narrative (cover → agenda → dividers-before-sections → closing)\n\nREJECT with `slide N: \u003Cissue>` lines, else \"Gate 3 PASS\" (HTML-text fallback adds \"\u003Cunverified-items> not visually verified\").\n\n**Fix-verify (mandatory, max 3 cycles).** Fix → re-run Gate 3 → repeat until zero new issues; one fix often surfaces another. After 3 rounds without convergence, **stop** — likely seesaw, template-level cause, or agent misread. Report `slide N: \u003Cissue> — attempted: \u003Cfixes> — likely root: \u003Ctemplate|design-conflict|ambiguous>` and let the user decide.\n\n## Common Pitfalls\n\nSanity-check cheatsheet — what breaks on the first try. Design + shell traps.\n\n| Pitfall | Correct approach |\n|---|---|\n| Unquoted `[N]` in zsh\u002Fbash | Always quote paths: `\"\u002Fslide[1]\"`. zsh globs unquoted `[1]` → `no matches found` — #1 first-use stumble |\n| `--name \"foo\"` | All attributes go through `--prop`: `--prop name=\"foo\"` |\n| `\u002Fshape[myname]` (bare name in brackets) | Use `@name=` selector: `\u002Fshape[@name=myname]` or `\u002Fshape[@id=10007]` |\n| Paths 1-based vs `--index` 0-based | `\u002Fslide[1]` = first slide; `--index 0` = first position |\n| `$` in `--prop text=` | Single-quote: `--prop text='$15M'`. Double-quoted `\"$15M\"` gets shell-expanded to `M` |\n| `\\n` \u002F `\\t` in `--prop text=` | Interpreted by the CLI: `\\n` = paragraph break, `\\t` = tab. Double `\\\\n` for a literal |\n","> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS \u002F Linux** (bash\u002Fzsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool\u002FCLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running:\n>\n> | bash (macOS \u002F Linux) | PowerShell (Windows) |\n> | --- | --- |\n> | `a && b` | run as two steps, or `a; if ($?) { b }` |\n> | `cat \u003C\u003C'EOF' \\| tool …` (heredoc) | write the text to a temp file, then pipe\u002Fpass that file to the tool |\n> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` |\n> | `cmd > \u002Fdev\u002Fnull` | `cmd > $null` |\n> | `… \\| grep PAT` | `… \\| Select-String PAT` |\n> | `… \\| jq …` | `… \\| ConvertFrom-Json`, then read the fields |\n> | `python3 x.py` | `python x.py` (or `py x.py`) |\n> | `~\u002Fdir`, `\u002Ftmp` | `$env:USERPROFILE\\dir`, `$env:TEMP` |\n> | `cp` \u002F `mkdir -p` \u002F `rm -rf` | `Copy-Item` \u002F `New-Item -ItemType Directory -Force` \u002F `Remove-Item -Recurse -Force` |\n>\n> If a command has no obvious Windows equivalent, prefer the built-in file\u002FHTTP tools over raw shell.\n\n# OfficeCLI PPTX Skill\n\n## Setup\n\nIf `officecli` is missing:\n\n- **macOS \u002F Linux**: `curl -fsSL https:\u002F\u002Fd.officecli.ai\u002Finstall.sh | bash`\n- **Windows (PowerShell)**: `irm https:\u002F\u002Fd.officecli.ai\u002Finstall.ps1 | iex`\n\nVerify with `officecli --version` (open a new terminal if PATH hasn't picked up). If install fails, download a binary from https:\u002F\u002Fgithub.com\u002FiOfficeAI\u002FOfficeCLI\u002Freleases.\n\n## ⚠️ Help-First Rule\n\n**This skill teaches what good slides look like, not every command flag. When a property name, enum value, or alias is uncertain, consult help BEFORE guessing.**\n\n```bash\nofficecli help pptx                         # List all pptx elements\nofficecli help pptx \u003Celement>               # Full element schema (e.g. shape, chart, animation, connector, zoom, group)\nofficecli help pptx \u003Cverb> \u003Celement>        # Verb-scoped (e.g. add shape, set slide)\nofficecli help pptx \u003Celement> --json        # Machine-readable schema\n```\n\nHelp reflects the installed CLI version. When skill and help disagree, **help is authoritative**. Triggers to run help immediately: `UNSUPPORTED props:` warning, unknown animation preset, `connector.shape=` enum drifts, prop-vs-alias (`lineWidth` vs `line.width`, `color` vs `font.color`).\n\n## Shell & Execution Discipline\n\n**Shell quoting (zsh \u002F bash).** ALWAYS quote element paths (`\"\u002Fslide[1]\u002F...\"`) — zsh globs unquoted `[1]` to `no matches found`. Escaping happens at three layers — keep them separate (the CLI handles the second for you):\n\n1. **Shell.** `$` in a value still belongs to the shell — single-quote the whole value: `--prop text='$15M'`. Double-quoted `\"$15M\"` gets expanded to `M`. The CLI does NOT unescape `\\$` for you.\n2. **CLI (`text=`).** The two-char escapes `\\n` and `\\t` ARE interpreted, consistently across pptx \u002F docx \u002F xlsx — `\\n` is a line \u002F paragraph break, `\\t` is a tab. To produce a literal backslash-n in text, double it (`\\\\n`); this is rarely what you want.\n3. **JSON (batch).** Real newlines \u002F tabs can also be passed as `\"\\n\"` \u002F `\"\\t\"` inside a `\u003C\u003C'EOF'` heredoc; both forms produce the same result.\n\nIf in doubt, `view text` after writing and compare character-for-character.\n\n**Incremental execution.** One command → check exit code → continue. A 50-command script that fails at command 3 cascades silently. After any structural op (new slide, chart, animation, connector) run `get` before stacking more.\n\n## Requirements for Outputs\n\nThese are the deliverable standards every deck MUST meet. Violating any one = not done, regardless of content quality.\n\n### All decks\n\n**One idea per slide.** If a slide needs a second title to explain what it covers, split it. Dense \"everything about X\" slides lose the audience inside 3 seconds. Use a section divider to group related one-idea slides, not a mega-slide.\n\n**Explicit type hierarchy — do NOT rely on theme defaults.** Theme defaults drift between masters. Set sizes explicitly on every text shape.\n\n| Element | Minimum | Typical | Min shape height |\n|---|---|---|---|\n| Slide title | **≥ 36pt** bold | 36–44pt | ≥ 2cm |\n| Section \u002F subtitle | ≥ 20pt | 20–24pt | ≥ 1.2cm |\n| Body text | **≥ 18pt** | 18–22pt | ≥ 1cm |\n| Caption \u002F axis label | ≥ 10pt muted | 10–12pt | ≥ 0.6cm |\n\nRule of thumb: **min shape height ≈ font_pt × 0.05cm**. An 18pt sublabel in a 0.8cm-tall box will overflow — `view annotated` catches this.\n\nTitle must be **≥ 2× body size** (36pt over 20pt works; 28pt over 20pt looks timid). Four legit exceptions to body ≥ 18pt: chart axis labels, legends, footer \u002F page number, and ≤ 5-word KPI sublabels (e.g. \"Active users\"). Descriptive sentences must be ≥ 18pt. Left-align body; center only titles and hero numbers. If \"the cards won't fit\", drop cards instead of shrinking font.\n\n**Two fonts max, one palette.** One heading font + one body font (e.g. Georgia + Calibri) — a third *display* face is fine only for big numerals or the cover title, as long as that heading+body pair stays intact. One dominant brand color (60–70% weight) + one supporting + one accent. Never mix 4+ colors in body content. **The palettes and font pairings in Design Principles are a floor, not a menu:** if the user gave brand colors\u002Ffonts or an existing template, match those first; otherwise the named sets are calibrated seeds — blend or diverge freely, as long as the result isn't *worse* than them and still clears the contrast floor.\n\n**Every slide carries a non-text visual — one that informs.** Shape, chart, icon, gradient band that carries meaning, not decoration. A bullet-only deck is interchangeable with a Word doc. Exceptions: literal quote slides, code blocks, a single summary-table slide.\n\n**Less is more — every element earns its place.** The visual rule above guards against bullet-walls; it is not licence to clutter. Don't pad with decorative stats, icons, or filler sections that don't inform (\"data slop\"). If a slide feels empty, fix it with layout and whitespace, not invented content — cut scope rather than bulk it up, and flag a larger addition instead of making it unprompted.\n\n**Speaker notes on every content slide.** `--type notes --prop text=\"...\"`. The speaker needs a script; the audience shouldn't read the slide verbatim.\n\n**Copy reads human, not AI.** Titles orient on content, not punchline. No \"It's not X. It's Y.\", no manufactured tension, no faux-insight (\"The magic moment\"), no one-word drama (\"Momentum.\"). Cut hype adjectives (seamless, robust, game-changing) — let the number carry it.\n\n**Preserve existing templates.** When a file already has a theme and masters, match them. Existing conventions override these guidelines.\n\n### Visual delivery floor (applies to EVERY deck)\n\nBefore declaring done, the per-slide render (see QA) MUST satisfy:\n\n- **No placeholder tokens rendered as content.** `{{name}}`, `$fy$24`, `\u003CTODO>`, `lorem`, `xxxx`, empty `()`\u002F`[]` in chart titles never appear.\n- **No overflow off-edge, no clipped text in shapes.** `view issues` flags both (`shape_off_slide` + a text-fit hint). To fix a clip: grow the box or shorten the value — never trim content to fit.\n- **Cover carries its orienting elements.** Title + subtitle + presenter\u002Fclient + date + a brand band or key-takeaway strap — a title-only cover reads as a stub. Generous whitespace around them is still right; rich ≠ crowded.\n- **Contrast.** `view issues` auto-flags the common case — opaque dark text on a shape's own dark fill (`low_contrast`). It can't see the rest: icon \u002F chart-series fills, scheme\u002Finherited colors, or text over a *separate* background shape. So on any fill with brightness \u003C 30% (`1E2761`, `36454F`, deep forest \u002F berry \u002F cherry), still confirm every body run, card body, chart series, and icon is `FFFFFF` or brightness > 80% — mid-gray (`6B7B8D` ≈ 44%) reads on a laptop and vanishes on projection. Spot-check via `view html` after the dark-fill pass.\n\nIf any fails, STOP and fix before declaring done.\n\n## Design Principles\n\nA deck is not a document. The audience has 3 seconds to get each slide. Before adding anything, ask: \"If the audience reads only the biggest element and glances once, do they get the point?\" If they have to read the bullets, the biggest element is wrong.\n\n### Grid, margins, negative space\n\nStandard widescreen is **33.87 × 19.05cm**. Treat it as a 12-column grid internally:\n\n- **Edge margin ≥ 1.27cm** (0.5\") on all sides.\n- **Inter-block gap ≥ 0.76cm** (0.3\") between cards \u002F columns \u002F rows — pick one value (0.76 or 1.27cm) and use it everywhere; mixed gaps look unfinished.\n- **≥ 20% negative space per slide.** Filling every pixel reads as amateur.\n- **Compose, don't web-center.** Whitespace is structural: a slide top-weighted with open space in the lower third is correct composition, not an empty defect. Intentional asymmetry (content left, breathing room right) reads more designed than centering everything — don't fill a gap just because it's there.\n- For card grids: `usable = 33.87 − 2·margin − (N−1)·gap`, then `col_width = usable \u002F N`. Don't hand-pick x coordinates.\n\n### Font pairings\n\nPair by document register, not by novelty. \"Best For\" is a prompt, not a decree; a pairing outside this table is fine if it fits — these 8 are seeds, not the set.\n\n| Header | Body | Best For |\n|---|---|---|\n| Georgia | Calibri | Formal business, finance, executive reports |\n| Arial Black | Arial | Bold marketing, product launches |\n| Calibri | Calibri Light | Clean corporate, minimal design |\n| Cambria | Calibri | Traditional professional, legal, academic |\n| Trebuchet MS | Calibri | Friendly tech, startups, SaaS |\n| Impact | Arial | Bold headlines, event decks, keynotes |\n| Palatino | Garamond | Elegant editorial, luxury, nonprofit |\n| Consolas | Calibri | Developer tools, technical \u002F engineering |\n\nSet both fonts explicitly on every shape (`--prop font=Georgia` on titles, `--prop font=Calibri` on body), not via theme inheritance.\n\n### Color and contrast\n\nThe columns: **Primary** (dominant — 60–70% of weight, the color you see first), **Secondary** (supporting tone), **Accent** (sparing, one-hit emphasis), **Text** (body on light fills), **Muted** (captions \u002F axis labels \u002F footer).\n\n| Theme | Primary | Secondary | Accent | Text | Muted |\n|---|---|---|---|---|---|\n| Coral Energy | `F96167` | `F9E795` | `2F3C7E` | `333333` | `8B7E6A` |\n| Midnight Executive | `1E2761` | `CADCFC` | `FFFFFF` | `333333` | `8899BB` |\n| Forest & Moss | `2C5F2D` | `97BC62` | `F5F5F5` | `2D2D2D` | `6B8E6B` |\n| Charcoal Minimal | `36454F` | `F2F2F2` | `212121` | `333333` | `7A8A94` |\n| Warm Terracotta | `B85042` | `E7E8D1` | `A7BEAE` | `3D2B2B` | `8C7B75` |\n| Berry & Cream | `6D2E46` | `A26769` | `ECE2D0` | `3D2233` | `8C6B7A` |\n| Ocean Gradient | `065A82` | `1C7293` | `21295C` | `2B3A4E` | `6B8FAA` |\n| Teal Trust | `028090` | `00A896` | `02C39A` | `2D3B3B` | `5E8C8C` |\n| Sage Calm | `84B59F` | `69A297` | `50808E` | `2D3D35` | `7A9488` |\n| Cherry Bold | `990011` | `FCF6F5` | `2F3C7E` | `333333` | `8B6B6B` |\n\nPick by topic, not by default — finance reads Midnight Executive, a product launch reads Coral Energy, safety \u002F LOTO reads Cherry Bold. If the closest named theme is not quite right, blend (e.g. Forest primary + gold `D4A843` accent). Use **Text** on light fills, **Muted** for captions \u002F axis \u002F footer, `FFFFFF` or Secondary for body on dark fills.\n\nOn dark backgrounds, text and chart series follow the Hard rules contrast floor above.\n\n### Chart-choice decision table\n\nWrong chart type kills the 3-second test:\n\n| Data shape | Use | Avoid |\n|---|---|---|\n| Category comparison (A vs B vs C) | `column` (vertical) \u002F `bar` (≥ 6 categories, horizontal) | pie (slices merge), line (no time axis) |\n| Time series, 1–3 series | `line` | area (occlusion), bar (implies discrete) |\n| Part-of-whole, 2–5 slices | `pie` \u002F `doughnut` | pie with 8+ slices (unreadable) |\n| Correlation \u002F distribution | `scatter` | line (implies ordering) |\n| Multiple categories × metrics, dense | stacked `column` or heatmap | one chart per metric — consolidate |\n| KPI snapshot (single big number) | **Large-text shape** (60–72pt + ≤ 5-word sublabel), NOT a chart | gauge chart, tiny bar |\n\nRule of thumb: if > 3 series and > 8 categories, split into two charts or switch to a table.\n\n### Animation\n\nUse as much or as little as the brand and content call for — a formal finance deck trends to near-zero, a product launch can be more expressive. Animation is a tool, not décor. Three floors keep it from hurting the deck (none caps how much you use):\n\n- **Purposeful** — each one reveals or emphasizes (progressive bullet reveal, a build-up chart), never decorates. If it doesn't aid comprehension, cut it.\n- **Degrades gracefully** — pptx animation renders inconsistently across viewers (Keynote \u002F Slides \u002F web \u002F mobile) and may not play at all, so every slide must read correctly as a *static* frame. Never hide essential content behind a reveal.\n- **Verify live** — animation is runtime-only; `view html` and screenshots can't see it, so confirm in a real presentation viewer before shipping.\n\nTaste steer (not a ban): `fade` \u002F `appear` \u002F a single `zoom-entrance` with snappy durations (~hundreds of ms) fit most decks; `bounce` \u002F `swivel` \u002F `spin` \u002F `fly-from-edge` \u002F dense multi-object choreography usually read amateur — reach for them only when the brand is deliberately playful.\n\n### Layout patterns & data display\n\nVary layout across slides — repeating the same pattern makes every slide feel identical. These are common building blocks, not the full set — pick one per slide, or build a layout outside the table when the content calls for it:\n\n| Pattern | When to use | Key measurement |\n|---|---|---|\n| **Two-column** (text left, visual right) | Concept + evidence; feature + screenshot | Each col ≈ 14-15cm; gap 1cm |\n| **Icon rows** (icon in filled circle + bold header + description) | Feature lists, benefits, team roles | Icon circle 1.5-2cm; 3-4 rows max |\n| **2×2 or 2×3 grid** (card tiles) | Quadrant analysis, SWOT, option comparison | Gap ≥ 0.76cm; consistent card height |\n| **Half-bleed image** (full left or right half, content overlay on other side) | Hero moments, case study openers | Image 16-17cm wide; content column ≥ 14cm |\n| **Large stat callout** (60-72pt number + ≤5-word sublabel below) | Single KPI, milestone, market size | Use shape, NOT a chart; sublabel 14-16pt muted |\n\n**Data display quick rules:**\n- Comparison columns (before\u002Fafter, A vs B) beat a table for 2-3 options.\n- Timelines and process flows: numbered step shapes + connectors, not a bullet list.\n\n### Image treatment (only when a slide uses a photo \u002F screenshot \u002F logo)\n\n**Read the image first** (open the file) and choose treatment from what you see — don't place blind from a filename.\n\n- **Full-bleed photo** → size to COVER the region (crop edges), no border.\n- **Screenshot \u002F diagram \u002F logo** → size to FIT (never crop content). A transparent or fit image sits on a contrasting fill — drop a colored rectangle behind it, don't let it float on white.\n- **Text over a photo** → never raw on the image. Put it on a card, or lay a protection scrim between image and text (a dark rectangle at ~50–60% opacity, or a gradient fading from the text edge).\n- Never stretch (distort the aspect ratio); don't overlay text on a busy screenshot.\n- Prefer user-provided images \u002F brand assets; no emoji or self-drawn art unless asked.\n\n### Visual motif commitment\n\nPick ONE distinctive element (rounded image frames, section numbers in filled circles, single-side border band, diagonal accent strips) and carry it to every slide — commit across the whole deck; styling one slide and leaving the rest plain reads as abandoned. A secondary motif is fine only if it doesn't compete with the primary. Declare it in your build plan first: `## Motif: numbered circles in brand color`.\n\n### Visual AI-tells to avoid\n\n- **No decorative underline under slide titles.** A stripe \u002F rule below a heading is the single most common AI-slide tell — use whitespace or a background-color change instead.\n- **No rounded-corner card with a colored left-border accent stripe.** The other classic AI-slide tell — use a solid fill, a top accent band, or whitespace separation instead.\n- **No emoji as iconography** unless the brand uses them — use a shape or a real icon asset.\n\nCopy-level tells live in \"Copy reads human\".\n\n## Common Workflow\n\n1. **Open\u002Fclose mode.** Always `officecli open \u003Cfile>` at start + `officecli close \u003Cfile>` at end. Resident is the default, not an optimization. Use `batch` for repetitive shape grids.\n2. **Orient.** New deck: `officecli create \"$FILE\"`. Existing: `officecli view \"$FILE\" outline` first. Never edit blind.\n3. **Title sequence first (plan, don't build yet).** Before creating any slide or shape, write out the full ordered list of slide titles. If someone reading ONLY the titles can't follow the argument, fix the arc now — cheaper in a list than after 14 slides. Pick ONE title grammar — all topic noun-phrases or all action statements, never a mix — and hold it throughout (see \"Copy reads human\").\n4. **Build in display order.** Add slides in audience-view order: cover → agenda → section-1 divider → section-1 content → section-2 divider → … → closing. `--index` on slide add works, but linear append keeps the build script readable and avoids index-arithmetic bugs. **Before final delivery, confirm slide count + narrative arc match your build plan.** Gate 3's order-sanity check catches cases where the cover ends up as slide 11 of 14 instead of slide 1.\n5. **Incremental per slide.** Create slide + background, then title, then supporting shapes \u002F charts \u002F connectors. Always `layout=blank` for custom designs. After each structural op, `get \u002Fslide[N] --depth 1` to confirm shape IDs.\n6. **Format to spec.** Per the Requirements table; formatting is deliverable, not polish.\n7. **Close + verify.** `officecli close` writes the ZIP. Always open in the target presentation viewer before shipping — chart colors, animations, fonts, and zoom are runtime features `view html` can't render. Full verification in QA below.\n8. **QA — assume there are problems.** Fix-and-verify until a cycle finds zero new issues.\n\n## Quick Start\n\nMinimal viable deck: cover + one content slide + notes. `$FILE` stands in for your filename.\n\n```bash\nFILE=\"deck.pptx\"\nofficecli create \"$FILE\"\nofficecli open \"$FILE\"\n\n# Cover — dark fill, centered title\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761\nofficecli add \"$FILE\" \u002Fslide[1] --type shape --prop text=\"FY26 Strategic Review\" \\\n  --prop x=2cm --prop y=7cm --prop width=29.87cm --prop height=3cm \\\n  --prop font=Georgia --prop size=44 --prop bold=true --prop color=FFFFFF --prop align=center\n\n# Content — white fill, title + body + notes\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=FFFFFF\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop text=\"Revenue grew 18% YoY\" \\\n  --prop x=1.5cm --prop y=1.2cm --prop width=30cm --prop height=2cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop text=\"Enterprise renewals + new EMEA region drove the beat; NRR held at 118%.\" \\\n  --prop x=1.5cm --prop y=4cm --prop width=30cm --prop height=3cm \\\n  --prop font=Calibri --prop size=20 --prop color=333333\nofficecli add \"$FILE\" \u002Fslide[2] --type notes --prop text=\"Lead with the 18% beat, preview EMEA.\"\n\nofficecli close \"$FILE\"\nofficecli validate \"$FILE\"\n```\n\nShape of every build: open → slide+background → title → body → notes → close → validate.\n\n## Reading & Analysis\n\nStart wide, then narrow. `outline` first, `view text` \u002F `get` \u002F `query` once you know where to look.\n\n```bash\nofficecli view \"$FILE\" outline          # slide count + titles\nofficecli view \"$FILE\" annotated        # complete per-slide breakdown with fonts, sizes, tables, charts\nofficecli view \"$FILE\" text --start 1 --end 5   # text dump (includes table cell text)\nofficecli view \"$FILE\" issues           # empty slides, overflow hints\nofficecli view \"$FILE\" stats            # counts + totals (incl. pictures missing alt)\n```\n\n**Inspect one element.** XPath-style paths, 1-based. ALWAYS quote. Prefer `@name=` \u002F `@id=` selectors over positional `[N]` (stable across reorderings). `[last()]` works. Add `--json` for machine output.\n\n```bash\nofficecli get \"$FILE\" \"\u002Fslide[1]\" --depth 1              # shape list with IDs and names\nofficecli get \"$FILE\" \"\u002Fslide[1]\u002Fshape[@name=Title]\"\nofficecli get \"$FILE\" \"\u002Fslide[1]\u002Ftable[1]\" --depth 3     # table rows \u002F cells\n```\n\n**Query across the deck.** CSS-like selectors; operators `=`, `!=`, `~=`, `>=`, `\u003C=`, `[attr]`, `:contains()`, `:no-alt`. `help pptx query` lists queryable element types.\n\n```bash\nofficecli query \"$FILE\" 'shape:contains(\"Revenue\")'\nofficecli query \"$FILE\" 'picture:no-alt'                 # accessibility gap\nofficecli query \"$FILE\" 'shape[fill=1E2761]'             # color match\nofficecli query \"$FILE\" 'shape[width>=10cm]'             # numeric\n```\n\n**`query --json` output schema.** Results wrap in `.data.results[]` — `jq -r '.data.results[0].format.id'`, NOT `.[0].id`. Shape name is `.name`; fill is `.format.fill`; textColor is `.format.textColor`.\n\n**Visual preview (LEAD).**\n\n```bash\nofficecli view \"$FILE\" html                # prints an HTML preview path; Read it for per-slide visual audit (best structural ground truth)\nofficecli view \"$FILE\" svg --start 3 --end 3   # single slide SVG (charts + gradients do NOT render in SVG)\n```\n\n**Reading the output — an expected non-defect:**\n- **`layout=blank` has no title placeholder.** Titles are plain `shape` elements, so `view outline` reporting `(untitled)` is **expected**, not a defect. Use `layout=title` + `placeholder[title]` only when screen-reader outline compatibility matters.\n\n## Creating & Editing\n\nVerbs: `add` \u002F `set` \u002F `remove` \u002F `move` \u002F `swap` \u002F `batch` \u002F `raw-set`. Ninety percent of a deck is slides, shapes, text, a few charts, pictures, connectors.\n\n### Slides and backgrounds\n\nA slide is `\u002Fslide[N]`. Always pass `layout=blank` for custom designs. Background: solid, gradient, or image.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761                 # solid\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop \"background=1E2761-CADCFC-180\"   # gradient (start-end-angle)\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=image:\u002Fpath\u002Fto\u002Fhero.jpg  # image background (LEAD)\n```\n\n### Shapes\n\nA `shape` holds text, fill, border, position, and optional animation \u002F link.\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[2] --type shape --prop name=Title --prop text=\"Key Insight\" \\\n  --prop x=2cm --prop y=2cm --prop width=20cm --prop height=3cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761 --prop fill=none\n```\n\nPositioning is explicit — no layout engine, you own the grid math. `--prop preset=` picks geometry (`rect`, `roundRect`, `ellipse`, `triangle`, `arrow`, `star5`, ...); custom `M...Z` paths are not supported — pick a preset. **Name shapes at creation** (`--prop name=HeroTitle`) and address later with `\"\u002Fslide[N]\u002Fshape[@name=HeroTitle]\"` — names survive z-order \u002F remove-then-add, whereas positional `\u002Fshape[3]` (and even `@id=`) shift. Re-`get --depth 1` after any structural change before using positional indexes.\n\n### Text inside shapes (paragraphs, runs, styling)\n\nA shape has paragraphs (`paragraph[K]`) and runs (`run[K]`). For one-line text, `--prop text=` on the shape is enough; a `\\n` in the text makes a paragraph break, `\\t` a tab (see Shell & Execution Discipline; double `\\\\n` for a literal). `add --type paragraph` takes the same style props as a shape (text, align, bold, italic, size, color, font). For mixed styling *within* a line, append a styled run:\n\n```bash\nofficecli add \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=Card1]\u002Fparagraph[1]\" --type run \\\n  --prop text=\" (inline detail)\" --prop size=14 --prop italic=true --prop color=8899BB\n```\n\n### Charts\n\nPick chart type per the Design Principles chart-choice table. Full prop list (chartType enum, `seriesN.*`, `data=`\u002F`categories=`, axis options): `help pptx add chart`. Typical multi-series with brand colors:\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[3] --type chart --prop chartType=column \\\n  --prop series1.name=Revenue --prop series1.values=\"42,45,48\" --prop series1.color=1E2761 \\\n  --prop series2.name=Growth  --prop series2.values=\"2,7,7\"    --prop series2.color=CADCFC \\\n  --prop categories=\"Q1,Q2,Q3\" \\\n  --prop x=2cm --prop y=4cm --prop width=20cm --prop height=10cm\n```\n\nGotchas: (1) chart titles with `()`, `[]`, `TBD` ship as literal text. (2) some viewers normalize chart colors to theme defaults — verify in the target viewer. Series can be added after creation (`add --type series`).\n\n### Pictures\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[4] --type picture --prop src=hero.jpg \\\n  --prop x=1cm --prop y=1cm --prop width=32cm --prop height=18cm \\\n  --prop alt=\"Product hero, gradient lit from right\"\n```\n\nConfirm with `officecli query \"$FILE\" 'picture:no-alt'` — must be empty before delivery.\n\n### Connectors (LEAD — flowcharts \u002F decision trees first-class)\n\nDraws a line between two shapes or free coordinates. Full prop \u002F enum reference (`shape`, `headEnd`\u002F`tailEnd` values, `from`\u002F`to` ref forms): `help pptx add connector`.\n\n```bash\nofficecli add \"$FILE\" \u002Fslide[5] --type connector \\\n  --prop \"from=\u002Fslide[5]\u002Fshape[@name=BoxA]\" --prop \"to=\u002Fslide[5]\u002Fshape[@name=BoxB]\" \\\n  --prop shape=elbow --prop color=333333 --prop tailEnd=triangle\n```\n\n**Every flow connector needs an arrowhead.** Without one, `bentConnector3` renders as a directionless line. `preset=rightArrow` overlay only works for horizontal flows; diamonds \u002F decision trees with diverging edges need `tailEnd=`.\n\n### Animations (LEAD)\n\nUse per the Animation floors above (purposeful, degrades gracefully, verify live). Preset names + duration syntax: `help pptx animation`.\n\n```bash\nofficecli set \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=HeroCard]\" --prop animation=fade-entrance-400\nofficecli set \"$FILE\" \"\u002Fslide[2]\u002Fshape[@name=HeroCard]\" --prop animation=none    # clear all\n```\n\n### Hyperlinks, tooltips, slide-jump\n\n`--prop link=slide[N]` for an in-deck jump (1-based; target slide must exist), `link=nextslide` \u002F `firstslide` \u002F `lastslide` \u002F `previousslide` \u002F `endshow` for named navigation, `link=https:\u002F\u002F...` for a URL, `--prop tooltip=\"...\"` for hover text.\n\n### Tables, placeholders, groups, zoom — one-liners\n\n- **Tables** — `--type table --prop rows=N --prop cols=M`. Row-level `set` supports `height` and `c1\u002Fc2\u002Fc3` (seed cell text). Header-row styling is table-level (`firstRow=true` \u002F `headerFill=`), not a row prop. Cell formatting lives on the cell paragraph \u002F run. Populate rows BEFORE setting table-level font (font cascade gets reset by row ops).\n- **Placeholders** — `\"\u002Fslide[N]\u002Fplaceholder[title]\"` \u002F `placeholder[body]`. Available only when the slide uses a layout with placeholders (not `layout=blank`).\n- **Groups** (LEAD) — address children via `\"\u002Fslide[N]\u002Fgroup[@name=G]\u002Fshape[1]\"`. Survives reordering better than positional indexes.\n- **Zoom slide** (LEAD) — `--type zoom --prop target=N` (one link per target; alias `slide`). Emit N separate zoom shapes for a multi-target nav hub. Zoom is a runtime feature — `view html` shows the static geometry; the zoom interaction runs only in a live presentation viewer.\n- **Slide comments** — reviewer annotations anchored at `\u002Fslide[N]\u002Fcomment[M]`. Full lifecycle (`add \u002F set \u002F get \u002F query \u002F remove`). Props: `text`, `author`, `initials` (auto-derived), `date` (ISO 8601, defaults to UtcNow), `x` \u002F `y` (length anchor).\n  ```bash\n  officecli add \"$FILE\" \"\u002Fslide[2]\" --type comment --prop author=\"Alice\" --prop text=\"Tighten this bullet\" --prop x=20cm --prop y=3cm\n  officecli query \"$FILE\" 'comment' --json | jq '.data.results | length'   # count all review comments\n  officecli remove \"$FILE\" \"\u002Fslide[2]\u002Fcomment[1]\"                           # resolve after addressing\n  ```\n\n### Deck-level recipes\n\nPatterns not obvious from the primitives. Each gives the **visual outcome** first, then a runnable block. `$FILE` = your filename. Use `\u002Fslide[last()]` to address the slide you just added. The recipes demonstrate **structure and coordinate math** — swap in the palette \u002F fonts you chose for this topic; the navy `1E2761` + Georgia is just the example's theme, not a house style to copy verbatim.\n\n**Z-order.** Later-added shapes are on top. Add background decoration FIRST, titles LAST. To fix after the fact: `--prop zorder=back\u002Ffront` (renumbers siblings — re-`get --depth 1` before stacking more).\n\n#### (a) Cover (and section divider)\n\n**Visual outcome.** Dark navy fill, centered 44pt title, 18pt ice-blue meta line.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=1E2761\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Strategic Growth Review\" \\\n  --prop x=2cm --prop y=7cm --prop width=29.87cm --prop height=3cm \\\n  --prop font=Georgia --prop size=44 --prop bold=true --prop color=FFFFFF --prop align=center\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Prepared for Acme Leadership — FY26 Outlook\" \\\n  --prop x=2cm --prop y=11cm --prop width=29.87cm --prop height=1.2cm \\\n  --prop font=Calibri --prop size=18 --prop color=CADCFC --prop align=center\n```\n\n**Section divider** = same cover, plus a giant translucent number (`size=120`, `opacity=0.15`) added FIRST so it sits behind the section title.\n\n#### (b) Data slide (chart + commentary block)\n\n**Visual outcome.** Left two-thirds: column chart with brand series colors. Right one-third: \"Key Insight\" card with 20pt heading + 18pt body — audience reads the takeaway before parsing the bars.\n\n```bash\nofficecli add \"$FILE\" \u002F --type slide --prop layout=blank --prop background=FFFFFF\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"FY26 Revenue Beat Plan by 18%\" \\\n  --prop x=1.5cm --prop y=1cm --prop width=30cm --prop height=1.8cm \\\n  --prop font=Georgia --prop size=36 --prop bold=true --prop color=1E2761\n\n# Chart — left 2\u002F3 (single-quote the title because of `$`)\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type chart --prop chartType=column \\\n  --prop series1.name=Actual --prop series1.values=\"42,45,48,55\" --prop series1.color=1E2761 \\\n  --prop series2.name=Plan --prop series2.values=\"40,42,45,48\" --prop series2.color=CADCFC \\\n  --prop categories=\"Q1,Q2,Q3,Q4\" --prop x=1.5cm --prop y=3.5cm --prop width=20cm --prop height=14cm --prop title='FY26 Revenue ($M)'\n\n# Commentary card — right 1\u002F3: background + heading + body\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop preset=roundRect --prop fill=F5F7FA --prop line=none \\\n  --prop x=22.5cm --prop y=3.5cm --prop width=9.8cm --prop height=14cm\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"Key Insight\" \\\n  --prop x=23cm --prop y=4cm --prop width=9cm --prop height=1.2cm \\\n  --prop font=Georgia --prop size=20 --prop bold=true --prop color=1E2761\nofficecli add \"$FILE\" \"\u002Fslide[last()]\" --type shape --prop text=\"EMEA launch + NRR at 118% drove 12pp of the 18pp beat.\" \\\n  --prop x=23cm --prop y=5.5cm --prop width=9cm --prop height=11cm \\\n  --prop font=Calibri --prop size=18 --prop color=333333\n```\n\n#### (c) Flowchart \u002F process diagram (boxes + connectors)\n\n**Visual outcome.** Four rounded boxes across at y=8cm, each 6×3cm, alternating navy\u002Ficeblue, joined by elbow connectors with triangle arrowheads.\n\nGrid math (4 boxes, 33.87cm slide, 1.5cm margins): `gap = (33.87 − 3 − 24) \u002F 3 = 2.29cm`. x-positions: `1.5, 9.79, 18.08, 26.37`.\n\nEach box carries its own label via `valign=middle` (no separate overlay shape needed). Use `batch` heredoc for portable coordinate arithmetic — no `bc`, no bash arrays.\n\n```bash\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step1\",\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"1.5cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 1\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step2\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"9.79cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 2\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step3\",\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"18.08cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 3\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Step4\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"26.37cm\",\"y\":\"8cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Step 4\",\"font\":\"Georgia\",\"size\":\"20\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}}\n]\nEOF\n\n# Connector pattern — reuse for any box-to-box graph.\nfor pair in \"Step1 Step2\" \"Step2 Step3\" \"Step3 Step4\"; do\n  A=${pair% *}; B=${pair#* }\n  officecli add \"$FILE\" \"\u002Fslide[$SLIDE]\" --type connector \\\n    --prop \"from=\u002Fslide[$SLIDE]\u002Fshape[@name=$A]\" \\\n    --prop \"to=\u002Fslide[$SLIDE]\u002Fshape[@name=$B]\" \\\n    --prop shape=elbow --prop color=333333 --prop tailEnd=triangle\ndone\n```\n\n`shape=elbow` is canonical (`bentConnector2` \u002F `bentConnector3` also accepted).\n\n#### (d) Multi-slide deck skeletons\n\nNo code block — it's a rhythm. The sequences below are **illustrations of one working cadence (alternating dark dividers with white content), not required running orders** — derive your actual arc from the content first (see \"Title sequence first\"), then borrow whatever divider\u002Fcontent rhythm fits:\n\n- **10-slide review:** Cover · Agenda · 3 KPI · Div01 · Chart · Chart · Div02 · Flow · Timeline · Close\n- **20-slide pitch:** same rhythm × 2, sectioned Problem · Solution · Market · Product · Traction · Model · Team · Financials · Ask\n- Every divider must appear **before** its section content (Gate 3 order sanity)\n- Cover\u002Fdivider = (a); chart pages = (b); process pages = (c); KPI pages = (e); decision pages = (f)\n\n#### (e) KPI callouts — giant-number card grid\n\n**Visual outcome.** Three or four giant numbers across a row; each card = unit sublabel + small percent-change chip + one-line takeaway. The single most common exec-deck element.\n\n**Sizing rule.** 60pt Georgia bold fits ~5 chars in a 9.78cm card (`$84.2`, `118%`, `24.5`). For longer values (`$84.2M`), split: `$84.2` as the big number, `USD millions` as the sublabel — never shrink the font to chase a unit suffix, it just wraps.\n\nGrid math (3 cards, 1.5cm margins, 0.76cm gap): `col_width = (33.87 − 3 − 1.52) \u002F 3 = 9.78cm`. x-positions: `1.5, 12.04, 22.58`. Use accent color on a single \"watch\" card so risk reads in one second.\n\n```bash\n# Two cards: navy standard + terracotta watch. Each = bg + big number + sublabel + chip.\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"preset\":\"roundRect\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"1.5cm\",\"y\":\"4cm\",\"width\":\"9.78cm\",\"height\":\"7cm\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"84.2\",\"x\":\"1.5cm\",\"y\":\"4.8cm\",\"width\":\"9.78cm\",\"height\":\"2.8cm\",\"font\":\"Georgia\",\"size\":\"60\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"USD millions · ARR\",\"x\":\"1.5cm\",\"y\":\"8cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"color\":\"CADCFC\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"+24% YoY\",\"x\":\"1.5cm\",\"y\":\"9cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"CADCFC\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"preset\":\"roundRect\",\"fill\":\"B85042\",\"line\":\"none\",\"x\":\"22.58cm\",\"y\":\"4cm\",\"width\":\"9.78cm\",\"height\":\"7cm\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"$1.42\",\"x\":\"22.58cm\",\"y\":\"4.8cm\",\"width\":\"9.78cm\",\"height\":\"2.8cm\",\"font\":\"Georgia\",\"size\":\"60\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"CAC payback (yrs)\",\"x\":\"22.58cm\",\"y\":\"8cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"color\":\"FFFFFF\",\"align\":\"center\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"text\":\"+8% — watch\",\"x\":\"22.58cm\",\"y\":\"9cm\",\"width\":\"9.78cm\",\"height\":\"0.8cm\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\"}}\n]\nEOF\n```\n\n#### (f) Decision tree — YES\u002FNO branching\n\n**Visual outcome.** Diamond at top-center; YES\u002FNO child boxes diverging left-right; both converge into a shared terminal box. Layout: diamond at `x=13.94, y=2cm, 6×3cm`; YES at `3cm, 7.5cm`; NO at `22.87cm, 7.5cm`; terminal at `13.94cm, 13cm`. Convention: red = stop\u002Fescalate, blue = standard, green = safe terminal. **Every connector needs an arrowhead** — readers misparse direction otherwise.\n\n```bash\ncat \u003C\u003CEOF | officecli batch \"$FILE\"\n[\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Decide\",\"preset\":\"diamond\",\"fill\":\"1E2761\",\"line\":\"none\",\"x\":\"13.94cm\",\"y\":\"2cm\",\"width\":\"6cm\",\"height\":\"3cm\",\"text\":\"Hazardous energy present?\",\"font\":\"Calibri\",\"size\":\"14\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"YesBox\",\"preset\":\"roundRect\",\"fill\":\"B85042\",\"line\":\"none\",\"x\":\"3cm\",\"y\":\"7.5cm\",\"width\":\"8cm\",\"height\":\"3cm\",\"text\":\"Lockout + Tagout + Verify\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"NoBox\",\"preset\":\"roundRect\",\"fill\":\"CADCFC\",\"line\":\"none\",\"x\":\"22.87cm\",\"y\":\"7.5cm\",\"width\":\"8cm\",\"height\":\"3cm\",\"text\":\"Proceed with standard PPE\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"1E2761\",\"align\":\"center\",\"valign\":\"middle\"}},\n  {\"command\":\"add\",\"parent\":\"\u002Fslide[$SLIDE]\",\"type\":\"shape\",\"props\":{\"name\":\"Done\",\"preset\":\"roundRect\",\"fill\":\"2C5F2D\",\"line\":\"none\",\"x\":\"13.94cm\",\"y\":\"13cm\",\"width\":\"6cm\",\"height\":\"2.5cm\",\"text\":\"Begin service\",\"font\":\"Calibri\",\"size\":\"16\",\"bold\":\"true\",\"color\":\"FFFFFF\",\"align\":\"center\",\"valign\":\"middle\"}}\n]\nEOF\n```\n\nThen 4 connectors (`Decide→YesBox`, `Decide→NoBox`, `YesBox→Done`, `NoBox→Done`) using the connector loop pattern from (c).\n\n## QA (Required)\n\n**Assume there are problems.** First render is almost never correct. If you found zero issues, you were not looking hard enough.\n\n### Delivery Gate (any failure = REJECT, do NOT deliver)\n\nGates 1–2b are text\u002Fschema-level (cannot see a rendered slide); Gate 3 is the only visual check. Done = every gate PASS **and** Gate 3 loop converged.\n\nEach gate is **run a command, judge its output** — the officecli commands are identical on every OS (macOS \u002F Linux \u002F Windows), so no shell scripting is needed; the judging is yours.\n\n- **Gate 1 — schema.** `officecli validate \"\u003Cfile>\"`. Any schema error → REJECT and fix.\n- **Gate 2 — overflow \u002F format \u002F structure.** `officecli view \"\u003Cfile>\" issues`. If it lists *any* issue (lines tagged `[O1]`, `[C1]`, `[S1]`, …) → REJECT, fix, re-run until clean.\n- **Gate 2b — leftover placeholders.** `officecli view \"\u003Cfile>\" text`, then scan the output for `xxxx`, `lorem` \u002F `ipsum`, `\u003CTODO>`, `placeholder`, \"this slide layout\", or empty `()` \u002F `[]`. Any hit → REJECT.\n\n### Gate 3 — Visual audit (MANDATORY)\n\nPick **one** path:\n\n**Screenshot (default)** — needs image-Read + a headless browser. Screenshot each slide in turn — `officecli view \"\u003Cfile>\" screenshot --page 1 -o slide1.png`, then `--page 2`, … — until the page index runs past the deck (one screenshot = one slide). If it errors on page 1, there's no headless backend → use the fallback below.\n\n**Judge every PNG against the checklist, adversarially** — \"assume problems exist; finding none means you didn't look hard enough.\" Report one `slide N: \u003Cissue>` line per problem, or `PASS`. This step is required however you run it. **If** your harness can spawn a subagent, delegate the judging to a *fresh, independent* one — the agent that built the deck is biased toward \"looks fine\", a separate pair of eyes is more critical — handing it the screenshots + this checklist and the same adversarial framing. No subagent? Do exactly the same yourself.\n\n**Fallback — HTML-text** (no image-Read or no browser): read `view \"$FILE\" html` as text. DOM cannot prove **dark-on-dark \u002F fine overlap \u002F arrowheads \u002F gap-margin metrics \u002F column alignment** — flag these as \"not visually verified\" rather than PASS.\n\n**Optional `--grid N`** — only on user request for layout-rhythm, or when `view outline` shows anomalous layout distribution: `officecli view \"\u003Cfile>\" screenshot --grid 3 -o grid.png`.\n\n**Per-slide checklist (assume issues exist):**\n\n- **overlap** — shapes \u002F charts \u002F giant decorative numbers (01\u002F02\u002F03 100pt+) colliding\n- **text overflow** — clipped at slide or shape boundary (KPI cards, narrow boxes)\n- **narrow text box** — content fits technically but wraps to many short lines (1–2 words each); long sublabel in a 3cm KPI card, body line in a too-tight column\n- **dark-on-dark** — fill brightness \u003C 30% with text\u002Ficon brightness \u003C 80% (incl. dark icons on dark without a contrasting circle)\n- **image treatment** — photo stretched\u002Fdistorted, text raw on a busy image (no card\u002Fscrim), screenshot or logo cropped, transparent image floating on white\n- **missing arrowheads** — flowchart connectors as plain lines\n- **decorative-line \u002F title mismatch** — accent bar sized for one-line title but title wrapped to two (or vice versa)\n- **footer \u002F citation collision** — source line, page number, or footnote touching content above\n- **tight margin \u002F gap** — element within ~0.5\" of slide edge, or two cards within ~0.3\"\n- **uneven gaps** — large empty area on one side, cramped on another (broken rhythm)\n- **column \u002F repeat-element misalignment** — KPI cards \u002F icons off baseline or inconsistent width\n- **order sanity** — sequence matches narrative (cover → agenda → dividers-before-sections → closing)\n\nREJECT with `slide N: \u003Cissue>` lines, else \"Gate 3 PASS\" (HTML-text fallback adds \"\u003Cunverified-items> not visually verified\").\n\n**Fix-verify (mandatory, max 3 cycles).** Fix → re-run Gate 3 → repeat until zero new issues; one fix often surfaces another. After 3 rounds without convergence, **stop** — likely seesaw, template-level cause, or agent misread. Report `slide N: \u003Cissue> — attempted: \u003Cfixes> — likely root: \u003Ctemplate|design-conflict|ambiguous>` and let the user decide.\n\n## Common Pitfalls\n\nSanity-check cheatsheet — what breaks on the first try. Design + shell traps.\n\n| Pitfall | Correct approach |\n|---|---|\n| Unquoted `[N]` in zsh\u002Fbash | Always quote paths: `\"\u002Fslide[1]\"`. zsh globs unquoted `[1]` → `no matches found` — #1 first-use stumble |\n| `--name \"foo\"` | All attributes go through `--prop`: `--prop name=\"foo\"` |\n| `\u002Fshape[myname]` (bare name in brackets) | Use `@name=` selector: `\u002Fshape[@name=myname]` or `\u002Fshape[@id=10007]` |\n| Paths 1-based vs `--index` 0-based | `\u002Fslide[1]` = first slide; `--index 0` = first position |\n| `$` in `--prop text=` | Single-quote: `--prop text='$15M'`. Double-quoted `\"$15M\"` gets shell-expanded to `M` |\n| `\\n` \u002F `\\t` in `--prop text=` | Interpreted by the CLI: `\\n` = paragraph break, `\\t` = tab. Double `\\\\n` for a literal |\n",{"name":5,"description":7},"main","62fdfb59e6fd606e8fc9cd68daf24ae05fd5e8fe","crates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fofficecli-pptx","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core","https:\u002F\u002Fgithub.com\u002FDhanuzh","🌟 Full Stack Engineer | Go, React & Python Aficionado | Crafting Code & Dev Content","2026-08-19 20:53:44",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Dhanuzh\u002FDCode-Core --skill officecli-pptx",{"tool":37,"command":38},"bunx","bunx skills add Dhanuzh\u002FDCode-Core --skill officecli-pptx",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Dhanuzh\u002FDCode-Core --skill officecli-pptx","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fofficecli-pptx\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7AV0FCZ1A9Z8PBFCW4FYKAS","example-skill","Fixture skill used by startup_materialize integration tests.","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-extension\u002Ftests\u002Ffixtures\u002Fbuiltin-skills-fixture\u002Fexample-skill\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7AV0DASHV78315Y3SN6VVF8","xiaohongshu-recruiter","用于在小红书上发布高质量的 AI 相关岗位招聘帖子。包含自动生成极客风格的招聘封面图和详情图，并提供自动化发布脚本。当用户需要发布招聘信息、寻找 Agent 设计师或其他 AI 领域人才时使用。","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fxiaohongshu-recruiter\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7AV0AR2TK8WY0E9ZMMD454R","x-recruiter","用于在 X (x.com) 发布招聘帖子。包含文案规范、图片生成提示和自动化发布脚本。发布 AI 相关岗位或设计类岗位时优先使用。","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fx-recruiter\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AV08FZKD0QFEFSH1W9D230","weixin-file-send","Use when the user wants a local file or image sent back, such as \"send me the file\"\nor \"发给我\".","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fweixin-file-send\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7AV035Q5BG6ERWK9A9H1115","story-roleplay","Parse and apply character cards and world info files in multiple formats (PNG, WebP, JSON), fully compatible with SillyTavern format. Supports automatic parsing, keyword triggering, and dynamic updates.","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fstory-roleplay\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7ATZSQMNSDQM3JQ4BZ942HJ","openclaw-setup","OpenClaw usage expert: Helps you install, deploy, configure, and use OpenClaw personal AI assistant. Can diagnose issues, create bots, execute automated tasks, etc. Use when users need to install OpenClaw, configure Gateway, set up Channels, create Agents, troubleshoot issues, or perform OpenClaw-related operations.","https:\u002F\u002Fgithub.com\u002FDhanuzh\u002FDCode-Core\u002Fblob\u002Fmain\u002Fcrates\u002Fdcode-app\u002Fassets\u002Fbuiltin-skills\u002Fopenclaw-setup\u002FSKILL.md",[],[]]