Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-pptx

hyper-pptx

Verified

Use this skill when the user asks to build, edit, or read a PowerPoint deck - create a .pptx from an outline or analysis, add slide transitions or element animations, change text or fonts in a deck someone else made, remove slides, or open a .pptx and report what each slide says. Write a typed JSON spec, render with a bundled engine to a .pptx plus checked slide images, or inspect an existing deck before touching it. Do not use for slide images only, PDF-only output, Google Slides, or Keynote.

FileKindSize
SKILL.ko.mdmarkdown17.8 KB
SKILL.mdskill md15.9 KB
assets/evals/hyper-pptx-cases.jsonlother20.8 KB
assets/examples/media/city-night.jpgbinary82.6 KB
assets/examples/media/detail-square.jpgbinary109.2 KB
assets/examples/media/hero-landscape.jpgbinary30.2 KB
assets/examples/media/team-wide.jpgbinary24.4 KB
assets/examples/media/workspace-tall.jpgbinary23.5 KB
assets/examples/proposal.deck.jsonconfig3.9 KB
assets/examples/report.deck.jsonconfig3.2 KB
assets/examples/showcase.deck.jsonconfig9.1 KB
assets/preview/viewer.cssother1.5 KB
assets/preview/viewer.jsscript37.4 KB
assets/runtime/layout.jqother63.7 KB
assets/runtime/pptx-package.jqother59.5 KB
assets/runtime/workbook.jqother4.6 KB
references/motion.ko.mdmarkdown10.1 KB
references/motion.mdmarkdown9.4 KB
references/pptx-internals.ko.mdmarkdown10.5 KB
references/pptx-internals.mdmarkdown9.2 KB
references/research-charts.ko.mdmarkdown5.9 KB
references/research-charts.mdmarkdown5.3 KB
references/research-design.ko.mdmarkdown7.3 KB
references/research-design.mdmarkdown6.9 KB
references/research-images.ko.mdmarkdown5.3 KB
references/research-images.mdmarkdown4.7 KB
references/research-verification.ko.mdmarkdown6.2 KB
references/research-verification.mdmarkdown5.6 KB
references/spec-format.ko.mdmarkdown18.9 KB
references/spec-format.mdmarkdown17.2 KB
rules/deck-narrative.ko.mdmarkdown4.7 KB
rules/deck-narrative.mdmarkdown4.3 KB
rules/layout-and-typography.ko.mdmarkdown12.4 KB
rules/layout-and-typography.mdmarkdown11.0 KB
rules/render-and-verify.ko.mdmarkdown9.3 KB
rules/render-and-verify.mdmarkdown8.4 KB
scripts/edit-deck.shexecutablescript8.2 KB
scripts/inspect-deck.shexecutablescript14.1 KB
scripts/render-deck.shexecutablescript25.1 KB

rules/render-and-verify.md

View on GitHub
# Render And Verify

Use this rule file before the first render and before delivery. It owns the three commands, the report fields, the repair loop, and the closing report.

## 1. Create

```bash
bash <skill-dir>/scripts/render-deck.sh --spec <out-dir>/<slug>.deck.json --out-dir <out-dir> \
  [--name <slug>] [--formats pptx,html,png[,pdf]] [--scale 1-3] [--browser <path>] [--budget-ms <ms>] [--no-check]
```

- Defaults: `--formats pptx,html,png`, `--scale 1`, name taken from the spec file stem, `--budget-ms 30000`.
- `--browser` or `HYPER_PPTX_BROWSER` picks the renderer; `--list-browsers` prints the candidates that exist.
- Exit codes: `0` built and every check passed, `1` built but a layout check failed, `2` usage or spec error, `3` blocked (no browser, no zip, no runtime result).

Output on stdout is one JSON object:

| Field | Meaning |
|---|---|
| `status` | `pass` or `fail` |
| `slides` | slide count |
| `checks` | array of `{code, message}`; `LAYOUT_OVERFLOW` means text needs more room than its box, `LAYOUT_OUTSIDE` a shape crossing the slide edge, `LAYOUT_OVERLAP` two text blocks covering each other, `LAYOUT_SPARSE` a page using under a third of the canvas, `MOTION_INVALID` a timing tree PowerPoint would repair |
| `images` | `[{index, path}]` for the written PNGs |
| `pptx`, `html` | absolute paths, or `null` when not requested |

## 2. Inspect

```bash
bash <skill-dir>/scripts/inspect-deck.sh --file <deck.pptx> [--outline|--json] [--slide <n>] [--check]
```

Reports `slideCount`, size, fonts, and per slide: `shapes` (name, type, x, y, cx, cy, text), `notes`, `table` (2D array), `chart` (`{type, categories, series}`), and the shapes that leave the canvas.

- Run it on your own output when a check fails, and on someone else's deck before editing it.
- `--check` exits 1 when a slide has a shape outside the canvas.

## 3. Edit An Existing Deck

```bash
bash <skill-dir>/scripts/edit-deck.sh --file <in.pptx> --out <out.pptx> \
  [--replace "old=>new"]... [--set-font <name>] [--set-font-ea <name>] [--drop-slide <n>]... [--allow-miss]
```

- Only text nodes, typeface attributes, and the named slide parts change; layouts, masters, images, and custom XML from the original survive.
- A `--replace` that matches nothing is reported in `missed` and makes the run exit 1, because a phrase split across runs cannot be replaced safely. Shorten the search string and repeat, or rewrite the slide from a spec.
- `--drop-slide` removes the slide part, its relationships, its notes, its chart, the `sldId`, the relationship entry, and the content-type override, then revalidates every XML part.

## 4. The Repair Loop

Feedback is `checks` and what the PNGs show. The guard is `status: pass` plus a read of every PNG. The cap is three repair passes after the first render.

| Check code | Usual cause | Fix in the spec |
|---|---|---|
| `LAYOUT_OVERFLOW` | bullet text exceeds the box height | cut words, split the slide, or drop a bullet level |
| `LAYOUT_OUTSIDE` | a shape crosses the slide edge | reduce the row or column count |
| `LAYOUT_OVERLAP` | two text blocks cover each other | the spec put text where a caption or card already sits |
| `LAYOUT_SPARSE` | the page uses under a third of the canvas | a slide with one short line; give it a second element or merge it |
| `IMAGE_NO_ALT` | a picture has no alternative text | write `alt`; the picture is invisible without it |
| `IMAGE_REMOTE` | an image path is a URL | download the file and pass a local path |
| `IMAGE_UNREADABLE` | the pixel size cannot be read from the file | replace the file, or give a correct `aspect` |
| `MOTION_INVALID` | a slide has two timing trees, a repeated time-node id, or an animation target that names no shape on the slide | this is a writer bug unless a spec change removed a shape the animation still targets; re-render and report if it repeats |
| `RELATIONSHIP_BROKEN` | a package part is missing | this is a bug in the skill, not the spec; report it |
| `XML_INVALID` | malformed part | same as above |

A spec error is different from a check failure: an unknown transition, an unknown effect or trigger, a malformed gradient, or an animation target that matches nothing stops the run before anything is written, with exit 2 and the error code as the message (`TRANSITION_UNKNOWN`, `ANIMATION_EFFECT_UNKNOWN`, `ANIMATION_TRIGGER_UNKNOWN`, `ANIMATION_DIRECTION_UNKNOWN`, `ANIMATION_TARGET_EMPTY`, `GRADIENT_INVALID`, `PROCESS_TOO_FEW`, `PROCESS_TOO_MANY`). Each names the value it rejected, so the fix is to use one of the listed names rather than to weaken the check.

Motion is checked by reading the written XML, not the spec: `pp_check_motion` re-opens every `ppt/slides/slideN.xml` and counts `p:timing` trees, time-node ids, and `p:spTgt` targets. That is the only way to catch the failure mode where the writer and the layout disagree, because that produces a file that opens with a repair prompt rather than a file that fails here.

A pass that raises the check count is reverted. When three passes are spent, deliver nothing and report the remaining defects.

## 5. What A PNG Proves

The PNG is rendered by this package's own viewer at 1/9525 scale, from the same resolved JSON that produced the `.pptx`. It proves the geometry and the text fit. It does not prove the reader's PowerPoint will show the same font, and it does not prove a chart's axes match PowerPoint's renderer. State that limit when the deck matters.

Motion is not in the PNG. The preview shows the final state of each slide; a transition and an entrance leave no trace in a still image, so "the PNG looks right" says nothing about the animation. What was verified for motion is the XML and the three `MOTION_INVALID` conditions. Playback is unverified, and a deck with motion should be opened in PowerPoint before it is presented.

Charts and pictures are where this matters most: a combo's secondary axis, a scatter's x placement, and a `srcRect` crop are all drawn twice — once in the package, once in the preview. When the two disagree, the package is what the reader opens and the preview is what the author approved. Compare them on any slide where a chart or a picture carries the argument.

Looking at every PNG is not a formality. Three defects fixed while building this package passed every automated check and were visible only in the image: a combo that drew no bars, a scatter plotted as a diagonal, and an area chart filled with an opaque block that hid the grid.

## 5a. Determinism

Two renders of one spec must produce byte-identical `.pptx` files. Every part is stamped `1980-01-01 00:00`, the member list is sorted, and `zip -X` strips extra attributes. To confirm, render twice into different directories and compare `shasum -a 256`; the hashes must match. A mismatch means something reads the clock or the filesystem order, and a diff of two decks would show changes that are not changes.

## 6. Before Delivery

- `status: pass`, and the PNG of every slide was opened and read.
- `inspect-deck.sh --check` on the delivered file, with exit 0.
- Every slide and chart part validated against the ECMA-376 schema; `xmllint --schema` is the gate, not "PowerPoint opened it". Filter the `failed to load` import warnings out of the output before reading a result.
- Two renders of the spec hash identically.
- On a deck with motion: every `p:spTgt` names a shape on its slide, and the deck was opened once in PowerPoint. If PowerPoint is not available, say so in the report; do not claim the animation plays.
- Compare the deck against the spec's `slides` count and against the request: the same number of slides, the same claims, nothing invented.
- Report absolute paths for the `.pptx` (and the HTML and PNGs when written), the slide count, the palette and fonts, the checks that ran, and any limit that applies.

## Sources

> Checked 2026-11-13.

| Claim | Source |
|---|---|
| Presentation part structure and slide ordering | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |
| Notes and relationship parts | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-notes-slides> |
| Chart cached values | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-charts> |
| Deterministic zip output (fixed timestamps, `-X`) | <https://linux.die.net/man/1/zip> |

### Evidence grade

`LOCAL` — the exit codes, report fields, and check codes are read from the three scripts in this package and were exercised end to end on 2026-11-13, including a deliberate overflow and a repaired re-render.
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall