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/research-verification.ko.md

View on GitHub
# 리서치: 검증

열리는 덱이 옳은 덱은 아닙니다. 이 패키지는 파일을 넘기기 전에 서로 다른 네 가지를 증명하고, 각각은 나머지가 놓치는 결함을 잡습니다.

## 1. 네 개의 관문

| 관문 | 묻는 것 | 답하는 방법 | 실패 코드 |
|---|---|---|---|
| 구조 | 엄격한 읽는 쪽이 XML을 받아들이는가 | 슬라이드와 차트 파트를 ECMA-376 XSD로 검증 | 빌드 실패 |
| 배치 | 글자가 주어진 도형에 들어가는가 | 미리보기가 배치 후 텍스트 상자를 잼 | `LAYOUT_OVERFLOW` |
| 위치 | 캔버스 밖으로 나가거나 다른 것 위에 올라갔는가 | 렌더한 무대에서 절대 사각형을 비교 | `LAYOUT_OUTSIDE`, `LAYOUT_OVERLAP` |
| 균형 | 페이지를 실제로 쓰고 있는가 | 모든 내용의 경계 상자를 캔버스 대비 비율로 | `LAYOUT_SPARSE` |

넷이 독립인 것은 의도입니다. 들어가는 글자가 캡션 위에 올라갈 수 있고, 꽉 찬 페이지가 불균형할 수 있으며, 둘 다 완벽히 검증되는 XML에서 나올 수 있습니다.

## 2. 추정이 아니라 측정

글자 높이를 글자 수로 추정하는 것은 고정 폭이 아닌 모든 문자 체계에서 틀립니다. 이 패키지는 글꼴 계열과 포인트 크기에 대해 글자마다 폭을 재고, 상자가 가질 줄 수를 세어, 렌더를 보기 전에 카드 높이를 정합니다.

측정은 모형이므로 렌더가 확인입니다. 미리보기는 같은 상자를 9525분의 1 척도로 그린 뒤(포인트당 9525 EMU이므로 1 EMU는 정확히 1 CSS 픽셀이고, 12192000 × 6858000 캔버스는 1280 × 720 무대가 됩니다) 각 텍스트 요소의 `scrollHeight`와 `scrollWidth`를 읽습니다. 모형과 브라우저가 어긋나면 브라우저가 이기고, 보고서가 어느 도형인지 밝힙니다.

## 3. 결정성

같은 spec을 두 번 렌더하면 바이트 단위로 같은 파일이 나와야 합니다. 그렇지 않으면 두 덱의 차이가 변경이 아닌 변경으로 보입니다.

`.pptx`에서 이것을 깨는 것은 셋입니다. zip이 수정 시간을 기록하고, 아카이브 안 파일 순서가 파일 시스템이 돌려주는 대로이며, 문서 속성에 생성 날짜가 들어가는 경우가 많습니다.

이 패키지는 아카이브 전에 모든 파트의 시간을 `1980-01-01 00:00`으로 고정하고, 구성원 목록을 정렬하며, `zip -X`로 부가 속성을 지웁니다. 그러면 17장 데모 덱을 연달아 두 번 렌더한 결과가 같은 해시를 냅니다. 이 비교는 가정이 아니라 실행한 것입니다.

## 4. 조사기가 더하는 것

`inspect-deck.sh`는 자기가 만들지 않은 덱을 읽습니다. 슬라이드가 몇 장인지, 각 장이 무엇을 말하는지, 도형이 캔버스를 벗어나는지, 차트에 캐시 값이 있는지, 발표자 노트가 있는지 답합니다.

슬라이드는 파일 이름 순서가 아니라 `presentation.xml`이 선언한 순서로 읽습니다. 사전순 나열은 `slide10.xml`을 `slide2.xml` 앞에 두므로, 17장 덱이 개요를 순서 없이 보고했습니다. 이 패키지의 산출물을 검토하다 찾은 실제 결함입니다.

## 5. 여기서 증명하지 않는 것

- **파워포인트 실물.** 이 패키지를 만든 기계에 파워포인트도 리브레오피스도 없습니다. 스키마 유효성과 캐시 값은 실제 읽는 쪽이 파일을 연다는 명세 기반 논거이고, 그것이 여는 모습을 관찰한 것은 아닙니다.
- **글꼴 렌더링.** 덱은 글꼴 이름을 기록합니다. 그 글꼴이 없는 읽는 쪽은 다른 글꼴로 대체하고, 대체 글꼴의 줄바꿈은 잰 값과 다릅니다.
- **프로젝터 색.** 대비는 토큰 값으로 계산합니다. 특정 프로젝터가 그 값을 어떻게 내는지는 재지 않았습니다.

각 항목은 얼버무리지 않고 납품 보고에 적습니다.

## 6. 수리 루프

렌더하고, 보고서와 모든 PNG를 읽고, spec을 고치고, 다시 렌더합니다. 최대 세 번입니다. 검사 수를 늘린 회차는 되돌립니다. 넘침 하나를 고치면서 둘을 만든 수정은 잘못된 수정이기 때문입니다. 상한을 다 쓰면 덱을 넘기지 않고 남은 결함을 슬라이드와 도형 id로 밝힙니다.

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

예제 스펙은 검사가 잡은 결함 둘을 더 드러냈고, 검사한 스펙을 코드와 함께 두는 이유가 여기에 있습니다. 글머리 슬라이드는 `LAYOUT_OVERLAP`으로 실패했습니다. 가운데로 옮긴 텍스트 상자가 본문 높이 전체를 그대로 가져서 아래 끝이 바닥글까지 내려간 탓이고, 이제 상자는 블록 높이만 차지합니다. 타임라인은 상세 줄이 아예 없이 렌더됐고 아무 경고도 없었습니다. 문서에 적힌 필드는 `text`인데 배치가 `detail`을 읽었기 때문입니다. 없는 필드는 오류가 아니라 빈 상자가 되고, 빈 필드와 설정하지 않은 필드의 차이는 렌더된 화면을 봐야 드러납니다.

## Sources

> 확인 2026-11-14.

| Claim | Source |
|---|---|
| 납품 전 모든 슬라이드 썸네일 보기 | <https://github.com/anthropics/skills> |
| 한 덱 파일에 대한 조사·수정·검증 루프 | <https://github.com/EveryInc/hands-on-deck> |
| 패키지 파트 구조와 관계 해석 | <https://github.com/scanny/python-pptx> |
| 검증 단계로서의 렌더링 왕복 | <https://github.com/iOfficeAI/OfficeCLI> |
| 덱 검토 점검표 | <https://github.com/liustack/pptwise> |
| `pptx`는 선언된 슬라이드 순서를 가진 XML 파트의 zip | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |

### 근거 등급

`LOCAL` - 여기 적은 관문은 모두 이 패키지에서 실행됩니다. 결정성 해시, 스키마 전수 검사, 슬라이드 순서 결함은 2026-11-14에 스크립트를 돌려 얻었습니다. 5절의 한계는 빌드 기계에서 관찰한 부재이지 다른 환경에 대한 주장이 아닙니다.
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