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.ko.md

View on GitHub
# 렌더링과 검증

첫 렌더링 전과 전달 전에 이 규칙 파일을 사용합니다. 명령 셋, 보고 필드, 수정 반복, 마무리 보고를 담습니다.

## 1. 만들기

```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]
```

- 기본값은 `--formats pptx,html,png`, `--scale 1`이고 이름은 spec 파일 이름에서 가져옵니다. `--budget-ms`는 `30000`입니다.
- `--browser`나 `HYPER_PPTX_BROWSER`로 렌더러를 고르고, `--list-browsers`로 실제로 있는 후보를 봅니다.
- 종료 코드: `0`은 만들고 모든 검사 통과, `1`은 만들었지만 배치 검사 실패, `2`는 사용법 또는 spec 오류, `3`은 막힘(브라우저, zip, 런타임 결과 없음)입니다.

표준 출력은 JSON 객체 하나입니다.

| 필드 | 뜻 |
|---|---|
| `status` | `pass` 또는 `fail` |
| `slides` | 슬라이드 수 |
| `checks` | `{code, message}` 배열. `LAYOUT_OVERFLOW`는 글자가 상자보다 크다는 뜻이고 `OUTSIDE`는 도형이 슬라이드 경계를 넘는다는 뜻이며 `MOTION_INVALID`는 파워포인트가 복구를 제안할 타이밍 트리라는 뜻입니다 |
| `images` | 쓴 PNG의 `[{index, path}]` |
| `pptx`, `html` | 절대 경로, 요청하지 않았으면 `null` |

## 2. 읽기

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

`slideCount`, 크기, 글꼴과 슬라이드마다 `shapes`(이름, 종류, 좌표, 글자), `notes`, `table`(2차원 배열), `chart`(`{type, categories, series}`), 캔버스를 벗어난 도형을 보고합니다.

- 검사가 실패했을 때 자기 산출물에, 편집 전에 남의 덱에 실행합니다.
- `--check`는 캔버스를 벗어난 도형이 있으면 1로 끝납니다.

## 3. 기존 덱 편집

```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]
```

- 텍스트 노드, 글꼴 속성, 이름 붙인 슬라이드 파트만 바뀝니다. 원본의 레이아웃, 마스터, 이미지, 사용자 XML은 남습니다.
- 아무것도 못 찾은 `--replace`는 `missed`에 적히고 종료 코드 1이 됩니다. 실행이 나뉜 문구는 안전하게 바꿀 수 없기 때문입니다. 찾는 문자열을 줄여 다시 실행하거나, spec으로 슬라이드를 다시 씁니다.
- `--drop-slide`는 슬라이드 파트, 그 관계, 노트, 차트, `sldId`, 관계 항목, 콘텐츠 타입 항목을 지우고 모든 XML 파트를 다시 검사합니다.

## 4. 수정 반복

피드백은 `checks`와 PNG에서 보이는 것입니다. 통과 기준은 `status: pass`와 모든 PNG를 읽는 것입니다. 상한은 첫 렌더링 뒤 세 번입니다.

| 검사 코드 | 흔한 원인 | spec에서 고칠 곳 |
|---|---|---|
| `LAYOUT_OVERFLOW` | 글자가 상자 높이를 넘음 | 단어를 줄이거나, 슬라이드를 나누거나, 하위 항목을 뺍니다 |
| `LAYOUT_OUTSIDE` | 도형이 슬라이드 경계를 넘음 | 행이나 열 수를 줄입니다 |
| `LAYOUT_OVERLAP` | 글자 블록 둘이 서로를 덮음 | 캡션이나 카드가 이미 있는 자리에 글자를 놓았습니다 |
| `LAYOUT_SPARSE` | 캔버스의 3분의 1도 쓰지 않음 | 짧은 한 줄뿐인 슬라이드입니다. 요소를 하나 더 두거나 합칩니다 |
| `IMAGE_NO_ALT` | 그림에 대체 텍스트가 없음 | `alt`를 씁니다. 없으면 그림은 보이지 않는 것과 같습니다 |
| `IMAGE_REMOTE` | 이미지 경로가 주소임 | 파일을 내려받아 로컬 경로를 넘깁니다 |
| `IMAGE_UNREADABLE` | 파일에서 픽셀 크기를 읽을 수 없음 | 파일을 바꾸거나 맞는 `aspect`를 적습니다 |
| `MOTION_INVALID` | 한 슬라이드에 타이밍 트리가 둘, 시간 노드 id가 반복, 또는 그 슬라이드에 없는 도형을 지목하는 애니메이션 대상 | 애니메이션이 아직 지목하는 도형을 spec 변경이 지웠다면 spec 문제이고, 아니면 작성기 버그입니다. 다시 렌더링해 반복되면 보고합니다 |
| `RELATIONSHIP_BROKEN` | 패키지 파트가 빠짐 | spec 문제가 아니라 스킬 버그입니다. 보고합니다 |
| `XML_INVALID` | 파트 형식이 깨짐 | 위와 같습니다 |

spec 오류는 검사 실패와 다릅니다. 모르는 전환·효과·트리거, 형식이 틀린 그라디언트, 아무것도 맞지 않는 애니메이션 대상은 파일을 쓰기 전에 실행을 멈추고, 종료 코드 2와 함께 오류 코드를 메시지로 냅니다(`TRANSITION_UNKNOWN`, `ANIMATION_EFFECT_UNKNOWN`, `ANIMATION_TRIGGER_UNKNOWN`, `ANIMATION_DIRECTION_UNKNOWN`, `ANIMATION_TARGET_EMPTY`, `GRADIENT_INVALID`, `PROCESS_TOO_FEW`, `PROCESS_TOO_MANY`). 거부한 값을 함께 알려 주므로, 고칠 일은 검사를 약하게 만드는 것이 아니라 나열된 이름 중 하나를 쓰는 것입니다.

모션은 spec이 아니라 기록된 XML을 읽어 검사합니다. `pp_check_motion`이 `ppt/slides/slideN.xml`을 모두 다시 열어 `p:timing` 트리 수, 시간 노드 id, `p:spTgt` 대상을 셉니다. 작성기와 배치가 어긋나는 실패는 여는 순간 복구 안내로만 드러나므로, 이렇게 읽는 것 말고는 잡을 방법이 없습니다.

검사를 늘린 수정은 되돌립니다. 세 번을 다 쓰면 전달하지 않고 남은 결함을 보고합니다.

## 5. PNG가 증명하는 것

PNG는 `.pptx`를 만든 것과 같은 해석 JSON으로 이 패키지의 뷰어가 1/9525 축척으로 그립니다. 기하와 글자가 들어가는지를 증명합니다. 읽는 사람의 파워포인트가 같은 글꼴을 보여 준다는 것과, 차트 축이 파워포인트 렌더러와 같다는 것은 증명하지 않습니다. 중요한 덱이면 이 한계를 함께 적습니다.

차트와 그림에서 이 차이가 가장 큽니다. 혼합 차트의 보조 축, 산점도의 x 배치, `srcRect` 크롭은 패키지와 미리보기가 각각 한 번씩 그립니다. 둘이 어긋나면 읽는 사람이 여는 것은 패키지이고 작성자가 승인한 것은 미리보기입니다. 차트나 그림이 주장을 지는 슬라이드에서는 둘을 맞춰 봅니다.

모션은 PNG에 없습니다. 미리보기는 슬라이드의 최종 상태를 그리므로 전환과 등장은 정지 이미지에 흔적을 남기지 않습니다. "PNG가 맞다"는 애니메이션에 대해 아무것도 말하지 않습니다. 모션에서 확인한 것은 XML과 `MOTION_INVALID` 세 조건입니다. 재생은 확인하지 못했으므로, 모션이 있는 덱은 발표 전에 파워포인트에서 한 번 열어야 합니다.

PNG를 모두 보는 것은 형식이 아닙니다. 이 패키지를 만들며 고친 결함 셋은 자동 검사를 모두 통과했고 이미지에서만 보였습니다. 막대를 그리지 않은 혼합 차트, 대각선으로 그려진 산점도, 눈금선을 가린 불투명 면으로 채워진 영역 차트입니다.

## 5-1. 결정성

한 spec을 두 번 렌더링하면 바이트 단위로 같은 `.pptx`가 나와야 합니다. 모든 파트의 시간을 `1980-01-01 00:00`으로 고정하고, 구성원 목록을 정렬하며, `zip -X`로 부가 속성을 지웁니다. 확인하려면 다른 디렉터리에 두 번 렌더링하고 `shasum -a 256`을 비교합니다. 해시가 같아야 합니다. 다르면 무언가 시계나 파일 시스템 순서를 읽고 있다는 뜻이고, 두 덱의 차이가 변경이 아닌 변경으로 보이게 됩니다.

## 6. 전달 전에

- `status: pass`이고 슬라이드마다 PNG를 열어 읽었는지.
- 전달할 파일에 `inspect-deck.sh --check`를 돌려 0으로 끝났는지.
- 모든 슬라이드와 차트 파트를 ECMA-376 스키마로 검증했는지. 관문은 `xmllint --schema`이고 "파워포인트가 열었다"가 아닙니다. 결과를 읽기 전에 출력의 `failed to load` 가져오기 경고를 걸러 냅니다.
- 같은 spec을 두 번 렌더링한 해시가 같은지.
- 모션이 있는 덱이라면 모든 `p:spTgt`가 그 슬라이드에 있는 도형을 지목하는지, 파워포인트에서 한 번 열었는지. 파워포인트를 쓸 수 없으면 보고에 그렇게 적고, 애니메이션이 재생된다고 말하지 않습니다.
- spec의 `slides` 수와 요청이 맞는지. 슬라이드 수, 주장, 없는 내용을 만들지 않았는지.
- `.pptx`(그리고 쓴 경우 HTML, PNG)의 절대 경로, 슬라이드 수, 팔레트와 글꼴, 실행한 검사, 해당되는 한계를 보고합니다.

## Sources

> 확인 2026-11-13.

| Claim | Source |
|---|---|
| 프레젠테이션 파트 구조와 슬라이드 순서 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |
| 노트와 관계 파트 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-notes-slides> |
| 차트 값 캐시 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-charts> |
| 결정적 zip 출력(고정 시각, `-X`) | <https://linux.die.net/man/1/zip> |

### 근거 등급

`LOCAL` - 종료 코드, 보고 필드, 검사 코드는 이 패키지의 스크립트 셋에서 읽었고 2026-11-13에 일부러 넘침을 만들고 고쳐 다시 렌더링하는 과정까지 확인했습니다.
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