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

references/motion.md

View on GitHub
# Motion

Read this when a deck should not appear all at once: a transition between pages, an entrance on the argument, or a question about why an animation name was rejected.

## Contents

- What motion costs
- A transition belongs to the slide
- An animation belongs to shapes
- The nine effects and what they write
- Roles and targets
- Ids inside the timing tree
- What is deliberately not supported
- What was verified and what was not

## What Motion Costs

Motion is the one part of the package that fails quietly. A wrong transition name or a duplicated time-node id does not stop the file from opening; PowerPoint shows a repair prompt, and after the repair the slides are gone. Playback cannot be checked here because PowerPoint is not installed, so every rule below exists to keep the writer inside what the schema guarantees rather than what it hopes.

Two consequences run through the rest of the skill:

- Every name is checked against a closed list at layout time. An unknown name is an error, never a near-match.
- The animation target is a shape id that the layout pass assigns. Nothing is written from a name an author guessed.

The default is no motion. A deck with no `transition` and no `animation` produces exactly the bytes it produced before motion existed.

## A Transition Belongs to the Slide

```json
{ "transition": "fade" }
{ "transition": { "effect": "push", "speed": "fast" } }
{ "transition": false }
```

`transition` on the deck sets the default for every slide; a slide may override it. `false` and `"none"` both mean this slide has no transition. The resolved element is one direct child of `p:transition`, which itself is one direct child of `p:sld`:

```xml
<p:transition spd="med"><p:fade/></p:transition>
```

| Effect | What it does |
|---|---|
| `fade` | cross-fades the page |
| `cut` | no blend; the page swaps |
| `dissolve` | random-pixel dissolve |
| `push` | the new page slides in from `dir` |
| `wipe` | the new page is revealed along `dir` |
| `cover` | the new page covers the old one |
| `split` | the page opens from the centre outward |
| `strips` | vertical strips swap |
| `zoom` | the new page grows in |
| `plus` | the page opens along both axes |
| `pull` | the old page is pulled away on `dir` |
| `randomBar` | bars in random order |
| `checker` | squares |
| `blinds` | horizontal blinds |
| `diamond` | diamond wipe |
| `circle` | circle wipe |
| `wedge` | wedge wipe |
| `wheel` | one spoke |
| `random` | random effect |
| `comb` | comb wipe |
| `newsflash` | the page appears and shrinks |
| `morph` | PowerPoint 2019+ object morph |
| `none` | no transition |

Directions are not a field. Each effect that takes one has a fixed value in the schema (`p:push` is `dir="u"`), so a direction the author sets would be ignored by PowerPoint and the deck would animate differently than described. The writer emits the value the schema expects for the effect.

`spd` is `slow`, `med`, or `fast`. `morph` also carries `p14:dur` in milliseconds, because the modern attribute is what PowerPoint 2019 reads; `spd` is kept for older readers.

## Morph Is the One Wrapped Effect

`morph` is not an ECMA-376 element. It is a Microsoft extension from the `p159` namespace, so it is written inside `mc:AlternateContent`: a `Choice` that requires `p159` holds the morph, and a `Fallback` holds a plain fade. A reader that does not know the extension takes the fallback and shows a fade rather than refusing the file.

That is the only place in this package where markup-compatibility is used. Every other transition is a plain element, because wrapping them would add a namespace declaration PowerPoint does not need.

## An Animation Belongs to Shapes

```json
{ "animation": [
    { "effect": "fade", "target": "title", "trigger": "on-click" },
    { "effect": "fly", "target": "body", "direction": "up", "delay": 100 },
    { "effect": "grow", "target": "chart", "trigger": "after-previous" }
] }
```

| Field | Default | Meaning |
|---|---|---|
| `effect` | `fade` | one of the nine below |
| `target` | `all` | a role, a shape id, or an array of either |
| `trigger` | `on-click` | `on-click`, `with-previous`, `after-previous` |
| `direction` | `up` | `up`, `down`, `left`, `right`; used by `fly` and `wipe` |
| `duration` | `500` | milliseconds |
| `delay` | `0` | milliseconds after the trigger |

## The Nine Effects and What They Write

| Effect | Class | Writes |
|---|---|---|
| `appear` | entrance | a `p:set` on `style.visibility` |
| `fade` | entrance | that `p:set` plus `p:animEffect filter="fade"` |
| `wipe` | entrance | `p:animEffect filter="wipe(dir)"` |
| `split` | entrance | `p:animEffect filter="barn(inVertical)"` |
| `fly` | entrance | a `p:anim` on `ppt_x` or `ppt_y` from outside the slide |
| `zoom` | entrance | two `p:anim` nodes, width and height from zero |
| `grow` | emphasis | `p:animScale by="150000,150000"` |
| `spin` | emphasis | `p:animRot by="21600000"`, one full turn |
| `exitFade` | exit | `p:animEffect filter="fade"` out, then a `p:set` to hidden |

An entrance starts hidden because the `p:set` to `visible` runs first: without it the shape is on screen from the moment the slide appears, and the entrance has nothing to reveal. An exit does the reverse, and its `p:set` to hidden is delayed by `duration - 1` milliseconds so the shape does not vanish before its fade ends.

Preset ids make the effects appear in the animation pane under their own names instead of as custom animation: `appear` 1, `fly` 2, `grow` 6, `spin` 8, `fade` 10, `split` 16, `wipe` 22, `zoom` 23.

## Roles and Targets

An author writes a name; a slide has ids. Both resolve to the same shape ids in the layout pass:

| Target | Matches |
|---|---|
| `all` | every content shape; decoration and page furniture are skipped |
| `title`, `body`, `kicker`, `table`, `chart`, `image`, `decor` | shapes carrying that role |
| `s1` … `i1` … | the shape id the layout assigned |

`all` skipping decoration is deliberate. A rule under the title, a background block, a page number — if those animate, the page looks like it is assembling itself in front of the audience, which reads as a mistake rather than a style.

A shape with no declared role still has one: text is `body`, anything else is `decor`. Without that default an author would have to know the ids before the deck exists.

A target that matches nothing is `ANIMATION_TARGET_EMPTY`. A timing tree with no target still opens, and the symptom is a shape that never fades in, discovered live.

## Ids Inside the Timing Tree

Time-node ids are unique within a slide, not within the deck. Each animated row reserves four ids (the row, the visibility set, and up to two behaviour nodes) and each click-group wrapper takes one, so the counter advances by four per target and one per group. `pp_check_motion` re-reads the written XML and fails the render on three conditions:

| Condition | Code |
|---|---|
| more than one `p:timing` on a slide | `MOTION_INVALID` |
| a `p:cTn id` that repeats within the slide | `MOTION_INVALID` |
| a `p:spTgt spid` naming a shape not on the slide | `MOTION_INVALID` |

Those three are the failure modes that open with a repair prompt or silently do nothing. The check was verified by injecting a duplicate id and a missing target into a rendered deck and confirming both were reported.

## What Is Deliberately Not Supported

- No motion paths. `p:animMotion` needs a hand-authored path, and a wrong path is invisible until playback.
- No `p:media` or trigger-on-media.
- No per-character or per-word text build. Splitting a text box into animated sub-runs changes its runs, and the run structure is what `edit-deck.sh` searches.
- No sound.
- No animation on the master or the layout, so a slide's motion never inherits.

An author who needs one of these should build it in PowerPoint rather than have this package write XML nothing here can check.

## What Was Verified and What Was Not

Verified here, on 2026-11-14:

- All 23 transitions and 9 effects render without a layout error, with the expected element and attribute in `ppt/slides/slideN.xml`.
- Every `p:spTgt` names a `p:cNvPr` id that exists on the same slide.
- No slide has a duplicate `p:cTn id`.
- `pp_check_motion` catches an injected duplicate id and an injected missing target.

Not verified: playback. PowerPoint is not installed on this machine, so "does the morph look right on a projector" has no answer here. The XML matches the schema and the reference implementation; treat the first real presentation as the test.

## Sources

> Checked 2026-11-14.

| Claim | Source |
|---|---|
| `p:transition` is a child of `p:sld` and holds one effect element | <https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.presentation.slide> |
| Transition effect elements and their direction attributes | <https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.presentation.transition> |
| `p:timing` builds a tree of `p:cTn` nodes with targets in `p:spTgt` | <https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.presentation.timing> |
| Animation preset ids correspond to the named effects in the pane | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-presentations> |
| Morph is a `p159` extension and needs `mc:AlternateContent` | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-presentations> |

### Evidence grade

`LOCAL` — the element, attribute, and id rules were read from the writer and confirmed against the rendered XML in `ppt/slides/`. Playback is specification-based; PowerPoint is not available on this machine.
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