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/layout-and-typography.md

View on GitHub
# Layout And Typography

Use this rule file when a slide is crowded, when type looks wrong, or when a deck must read from the back of a room. The geometry itself lives in `assets/runtime/layout.jq`; this file explains the decisions a spec author has to make inside it.

## 1. The Grid

| Value | EMU | Inches |
|---|---|---|
| slide | 12192000 × 6858000 | 13.333 × 7.5 |
| margin | 609600 | 0.667 |
| text column | 10972800 | 12.0 |
| title baseline area | y 533400, height 838200 | 0.583, 0.917 |
| body top | y 1600200 | 1.75 |
| body bottom | y 6248400 | 6.833 |
| footer | y 6355080 | 6.95 |

Left edge is one margin for every element, including cards and tables. Nothing is centred horizontally except the image slide, because a centred column that does not match the title's left edge reads as a mistake.

## 2. Type Scale

| Role | Points | Why |
|---|---|---|
| title slide headline | 44 | the only 40+ element in a deck |
| section number | 15, accent colour | a label, not a heading |
| section title | 36 | |
| slide title | 30 | one line, about 20 Korean characters |
| lead line | 17 | one sentence under the title |
| body bullet | 18 to 22, grown from the block | the size a room reads; capped below the 30-point title |
| sub-bullet | 16 | derived: body minus 2 |
| column heading | 17, accent colour | |
| column bullet | 15 | |
| stat value | 46 | |
| stat label | 15 | |
| stat note | 12, muted | |
| table text | 13 | |
| caption | 12, muted | |
| quote | 32 | |
| statement | 40 / 34 / 28 by length | one sentence; the biggest thing on a dark page |
| bigstat value | 150 / 120 / 96 / 72 by length | nine characters or fewer; one number as the claim |
| bigstat label | 22 | the sentence that says what the number means |
| process heading | 18 to 20 | 18 from four steps up, so five columns still fit |
| process body | 15 | |
| footer and page number | 11, muted | |

Two rules follow. Body is never smaller than 15 points, because below that a projector turns text into texture. Emphasis comes from weight and colour, not from size: a 30-point title and an 18-point body differ enough that a 24-point "important" bullet only looks inconsistent.

A bullets slide grows its text to the block, not past it: the block is tried at 18, 19, 20, 21 and 22 points and the largest size that fits the body wins. The cap is 22 (`T_BODY_MAX`), so a four-bullet slide never renders its body larger than two thirds of the title. When the block still leaves room, the leftover is spread as extra space before each paragraph, up to 18 points per paragraph, rather than left as one dead strip at the bottom of the page.

## 3. Spacing

- `spaceBefore` is in points, and the default 6 is a paragraph gap, not a line gap. Line spacing is left to the reader and the font.
- Cards and stats use a 304800 EMU gap (0.333 inch). A wider gap breaks the row into separate things; a narrower one fuses them.
- A lead line pushes the body down by 640080 EMU. Do not also add space to the first bullet; the layout already moved the box. Blocks that centre in the body centre in what is left under the lead, so the lead stays attached to the thing it introduces.
- Vertical centring is for single-line boxes only. A multi-line box anchored to centre moves when text is edited, which makes two versions of the same slide look different. A block that is centred inside the body stops 640080 EMU below the title or the lead line: past about an inch the block reads as a separate page rather than the headline's evidence. The timeline is the exception, because a band that spans the width has to sit mid-height or its two margins disagree.
- A card is as tall as its tallest column needs, measured from the heading, the wrapped bullets, and the pad on each side, with a floor of 62% of the body so a row of three short cards still holds the page instead of collapsing into a strip near the title. The heading and bullets are then centred inside the card, so the extra height reads as padding rather than as missing content, and the row is centred in the space left under the lead line so the margins above and below it match. A row that cannot fit the body is reported as `LAYOUT_OVERFLOW` instead of being cropped silently.

## 4. Colour

- One accent colour per deck. It marks the one thing per slide the eye should hit first: a stat value, a column heading, the table header, the chart's first series.
- Muted colour is for text that supports: captions, notes, footer, sub-bullets. Never for a claim.
- Dark slides (title, section, quote) use the palette's dark tokens. Mixing a light body colour onto a dark background produces text that vanishes on a bad projector.
- Contrast: body text on background at least 4.5:1, and large text at least 3:1. The `ink` and `mono` palettes clear this; a custom `accent` must be checked before use as text.

## 5. Colour Blocks, Gradients, And Decoration

- `accent2` is the companion, not a second accent: a chart's second series, the badge on steps three to five, one block beside the main one. Two colours competing for the eye on one slide is one too many, so a page picks a lead.
- A gradient is a band, not a background wash. In practice that means one shape behind the text with an angle of `0` or `90`, and two colours from the same palette. A full-canvas gradient behind body text drops contrast at one end of the page, and the end that drops is whichever one the author did not check.
- Decoration stays behind and stays quiet: a band, a thin rule, a block at the edge. Anything that reads as content gets a role and a caption; anything that reads as decoration gets `role: "decor"` so `target: "all"` skips it.
- A dark slide keeps its palette. `darkSurface` and `darkAccent` exist so a coloured deck does not fall back to grey on its title and section pages; overriding `bg` and letting the dark tokens come from the palette is the normal case.
- One full-bleed element per page. A colour block, a gradient band, and an accent rule can coexist, but two competing full-width blocks turn a page into stripes.

## 6. Motion

- Motion is a reading order, not decoration. An entrance on the title, then the body, then the chart tells the room where to look. Everything animating at once is the same as nothing animating, only slower.
- `target: "all"` skips decoration on purpose. A rule under the title fading in makes the page look like it is assembling itself.
- `with-previous` groups things that belong together; `after-previous` spaces a list so each item lands after the one before. Do not mix the two in one run without a reason: the audience cannot tell whether the click or the clock moved the page.
- A transition is a chapter break. Use one effect for the whole deck, or one for section openers and nothing elsewhere. A different transition per slide reads as an accident.
- Durations of 400 to 700 milliseconds. Below 400 the eye misses the movement and it reads as a flicker; above 800 the room waits for the page.
- A statement or bigstat page already carries its content as the whole page. Animate the number, not the background; a band that stays still keeps the page from swimming.

## 7. Tables And Charts

- Table: header row filled with the accent, body rows alternating with the surface colour. Six columns maximum; the column width is equal, so a column of long sentences will wrap and push the row height.
- A table row height is derived from the body area divided by the row count and clamped to 0.35-0.8 inch. The 0.35 floor wins from 15 rows including the header (14 with a caption), the table then runs past the body bottom, and the renderer reports it as an overflow. Split the table before that.
- Chart: the first series takes the accent, the rest fall back to muted, line, and surface. A pie with more than five slices is unreadable; use a bar chart.
- Chart values must be numbers. A string value renders as a category label and silently produces a flat chart.
- Two units on one page take a `combo`: bars read the left axis, lines read a second axis on the right with no gridlines. Putting a rate and a volume on one axis flattens the rate onto the baseline, which reads as zero.
- A horizontal chart is for long category names; a vertical one rotates them. A stacked chart shows composition only when the total means something.
- A scatter's category is its x when it parses as a number. Do not plot the value on both axes: it draws a diagonal through the origin.

## 8. Images

- `fit` decides what is lost. `contain` keeps the whole picture and letterboxes the box, which is right when the picture is evidence such as a screenshot. `fill` keeps the box and crops the centre through `srcRect`, which is right for texture and for `hero`.
- Set `aspect` to the real width divided by height only when the file's size cannot be read. The layout reads pixel dimensions from the file header first, and a wrong `aspect` crops the wrong band or letterboxes a correct crop.
- Every picture carries `alt`. It is written as `descr`, announced by a screen reader, and shown when the image fails to load; a delivery without it is reported as `IMAGE_NO_ALT`.
- A caption reserves its own band above the picture's height, so it can never land on the picture it describes.
- `gallery` takes one to four pictures with a caption under each. Two pictures beside a paragraph of text is a layout problem, not a picture problem: use `imagetext` for one and `gallery` for the set.
- A photograph under text takes a flat scrim, `0.55` by default. Raise it for a busy picture, lower it for a dark one. A gradient scrim is invisible over a picture with its own light gradient and cannot be checked by reading a value.

## 9. What To Check Before Delivering

- Title on one line; if it wrapped, shorten it rather than shrinking the type.
- No bullet reaching past the text column, and no bullet ending in an ellipsis that came from truncation.
- Every caption directly under the thing it names, not under the next thing.
- The footer present on every slide except the title slide, with the correct page number.
- On a deck with motion: the first element on each slide is the one the reader should read first, and no page animates its decoration.

## Sources

> Checked 2026-11-13.

| Claim | Source |
|---|---|
| Slide dimensions, EMU, and the 16:9 geometry | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |
| Contrast ratios for text | <https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html> |
| Type size and line length for projected text | <https://www.w3.org/WAI/tutorials/images/complex/> |
| Chart series colour assignment and cached values | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-charts> |
| Linear gradients and their angle convention | <https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.gradientfill> |

### Evidence grade

`LOCAL` — the grid, the type scale, and the clamps are read from `assets/runtime/layout.jq` and were rendered and inspected slide by slide on 2026-11-13 and 2026-11-14. The contrast floor is the WCAG 2.2 minimum. The motion guidance is editorial; the durations were not measured on a projector.
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: 198kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall