[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78FQ6NTDMWT2EPM00FPMBMS":3,"skill-same:01M78FQ6NTDMWT2EPM00FPMBMS":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M78FQ6NTDMWT2EPM00FPMBMS","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.","shixianghua\u002FOfficeCLI-Enhanced","shixianghua","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F185889825?v=4","01M78FMF4JT83THYX5CF50WP85","01M78FMF5Q3AG5XA5A6KS5TQZK",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\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# 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 heredoc).** The recipes below pipe `cat \u003C\u003CEOF | officecli batch` **unquoted** so `$SLIDE` \u002F `$FILE` expand inside the body. That same unquoted heredoc also expands a literal `$` in a value: `\"$1.42\"` silently becomes `.42` and `\"$2.4B\"` becomes `.4B` (`$1` \u002F `$2` are empty shell params). **Escape currency as `\\$`** — `\"text\":\"\\$1.42\"` — which still lets `$SLIDE` expand. `\\n` \u002F `\\t` inside the JSON work either way. A fully-quoted `\u003C\u003C'EOF'` protects every `$` but then `$SLIDE` won't expand, so only use it when the body has no shell variables. After writing money values, `view text` and confirm the `$` survived.\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\u002Fsave lifecycle.** `officecli open \u003Cfile>` at the start, `officecli save \u003Cfile>` at the end to flush your edits to disk. `save` only writes — it leaves the resident warm for any follow-up edit; reach for `officecli close \u003Cfile>` only when you want to release the resident immediately (a one-shot handoff). Both are always safe — they never error or lose work. Use `batch` for repetitive shape grids. **Flush only at the non-officecli boundary:** officecli's own reads always see your edits; run `save`\u002F`close` only before a non-officecli program reads the file (python-pptx, PowerPoint, a renderer, delivery).\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. **Save + verify.** `officecli save` flushes the file to disk (or `officecli close` to flush and also end the session). 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 save \"$FILE\"\nofficecli validate \"$FILE\"\n```\n\nShape of every build: open → slide+background → title → body → notes → save → 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)** — for vision-capable agents. 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, 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 vision, or screenshot failed): 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**Then flush (part of the gate).** Once Gate 3 converges, end with `officecli save \"\u003Cfile>\"` — this guarantees your edits are written to disk before delivery (use `officecli close \"\u003Cfile>\"` instead to also release the resident on a one-shot handoff). Required final step, not optional. Always safe: never errors or loses work.\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","# 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 heredoc).** The recipes below pipe `cat \u003C\u003CEOF | officecli batch` **unquoted** so `$SLIDE` \u002F `$FILE` expand inside the body. That same unquoted heredoc also expands a literal `$` in a value: `\"$1.42\"` silently becomes `.42` and `\"$2.4B\"` becomes `.4B` (`$1` \u002F `$2` are empty shell params). **Escape currency as `\\$`** — `\"text\":\"\\$1.42\"` — which still lets `$SLIDE` expand. `\\n` \u002F `\\t` inside the JSON work either way. A fully-quoted `\u003C\u003C'EOF'` protects every `$` but then `$SLIDE` won't expand, so only use it when the body has no shell variables. After writing money values, `view text` and confirm the `$` survived.\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\u002Fsave lifecycle.** `officecli open \u003Cfile>` at the start, `officecli save \u003Cfile>` at the end to flush your edits to disk. `save` only writes — it leaves the resident warm for any follow-up edit; reach for `officecli close \u003Cfile>` only when you want to release the resident immediately (a one-shot handoff). Both are always safe — they never error or lose work. Use `batch` for repetitive shape grids. **Flush only at the non-officecli boundary:** officecli's own reads always see your edits; run `save`\u002F`close` only before a non-officecli program reads the file (python-pptx, PowerPoint, a renderer, delivery).\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. **Save + verify.** `officecli save` flushes the file to disk (or `officecli close` to flush and also end the session). 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 save \"$FILE\"\nofficecli validate \"$FILE\"\n```\n\nShape of every build: open → slide+background → title → body → notes → save → 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)** — for vision-capable agents. 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, 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 vision, or screenshot failed): 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**Then flush (part of the gate).** Once Gate 3 converges, end with `officecli save \"\u003Cfile>\"` — this guarantees your edits are written to disk before delivery (use `officecli close \"\u003Cfile>\"` instead to also release the resident on a one-shot handoff). Required final step, not optional. Always safe: never errors or loses work.\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","25382af4fdcb6903796fd330dc07db653b560d3a","skills\u002Fofficecli-pptx",0,"https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced","https:\u002F\u002Fgithub.com\u002Fshixianghua","2026-07-13 02:22:31",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add shixianghua\u002FOfficeCLI-Enhanced --skill officecli-pptx",{"tool":36,"command":37},"bunx","bunx skills add shixianghua\u002FOfficeCLI-Enhanced --skill officecli-pptx",{"tool":39,"command":40},"pnpm","pnpm dlx skills add shixianghua\u002FOfficeCLI-Enhanced --skill officecli-pptx","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-pptx\u002FSKILL.md",true,[],[45,51,58,65,72,79],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":18},"01M78FR19BZGX7ZZBC8G3ZJHG7","officecli","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M78FQTRP3J1DPJ6S7M5Y5KEX","officecli-xlsx","Use this skill any time a .xlsx file is involved -- as input, output, or both. This includes: creating spreadsheets, financial models, dashboards, or trackers; reading, parsing, or extracting data from any .xlsx file; editing, modifying, or updating existing workbooks; working with formulas, charts, pivot tables, or templates; importing CSV\u002FTSV data into Excel format. Trigger whenever the user mentions 'spreadsheet', 'workbook', 'Excel', 'financial model', 'tracker', 'dashboard', or references a .xlsx\u002F.csv filename.","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-xlsx\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M78FQEMC8QMB1XDX9AXSQ3MW","officecli-word-form","Use this skill to create fillable Word forms (.docx) with real Content Controls (SDT) + legacy FormField checkboxes + MERGEFIELD mail-merge placeholders + document protection. Trigger on: 'fillable form', 'form fields', 'content controls', 'SDT', 'word form', 'fill in', 'only editable fields', 'protect document', 'onboarding form', 'HR intake', 'survey template', 'contract \u002F SOW template', 'mail-merge template', 'compliance checklist', 'medical intake questionnaire'. Output is a single .docx where specific fields are editable and the rest is locked. This skill is INDEPENDENT, not a scene layer on docx — payload is `\u003Cw:sdt>` + `\u003Cw:ffData>` + `\u003Cw:fldChar>` + `documentProtection`, none of which docx base skill covers. Do NOT trigger for regular reports, letters, memos, academic papers, pitch decks, or any document with no user-fillable fields — route those to officecli-docx or its scene layers.","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-word-form\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M78FPRJPMZ640WWGFQZ11TFG","officecli-pitch-deck","Use this skill when the user is building a fundraising \u002F investor pitch deck — seed, Series A \u002F B \u002F C, convertible note, SAFE round, strategic raise. Trigger on: 'pitch deck', 'investor deck', 'Series A deck', 'Series B deck', 'Series C deck', 'fundraising deck', 'seed pitch', 'VC deck', 'raising capital', 'term sheet presentation'. Output is a single .pptx. This skill is a scene layer on top of officecli-pptx — inherits every pptx v2 rule (visual floor, grid, palettes, connector canon, Delivery Gate). DO NOT invoke for a generic board review, sales deck, all-hands, or product launch — route those to officecli-pptx base.","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-pitch-deck\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M78FPCYEK6A5DFP5BZBVMZPA","officecli-financial-model","Use this skill when the user wants to build a financial model — 3-statement model, DCF valuation, LBO, SaaS unit economics, sensitivity \u002F scenario analysis, debt schedule, or fundraising projections — in Excel. Trigger on: 'financial model', '3-statement model', 'P&L + BS + CF', 'DCF', 'WACC', 'NPV', 'terminal value', 'LBO', 'debt schedule', 'cash sweep', 'MOIC', 'IRR \u002F XIRR', 'sensitivity table', 'scenario analysis', 'ARR model', 'unit economics', 'CAC \u002F LTV', 'cap table forecast'. Output is a single formula-driven .xlsx. This skill is a scene layer on top of officecli-xlsx — it inherits every xlsx v2 rule (4-color code, visual floor, number formats, cache-drift, Known Issues, Delivery Gate minimum cycle). DO NOT invoke for a simple budget tracker, CSV dump, or operational KPI sheet — route those to officecli-xlsx base.","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-financial-model\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M78FP50A5PCW0P1YMPW5FTYJ","officecli-docx","Use this skill any time a .docx file is involved -- as input, output, or both. This includes: creating Word documents, reports, letters, memos, or proposals; reading, parsing, or extracting text from any .docx file; editing, modifying, or updating existing documents; working with templates, tracked changes, comments, headers\u002Ffooters, or tables of contents. Trigger whenever the user mentions 'Word doc', 'document', 'report', 'letter', 'memo', or references a .docx filename.","https:\u002F\u002Fgithub.com\u002Fshixianghua\u002FOfficeCLI-Enhanced\u002Fblob\u002Fmain\u002Fskills\u002Fofficecli-docx\u002FSKILL.md",[],[]]