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

View on GitHub
# 리서치: 이미지

그림 배치는 생성한 덱이 가장 자주 어색해 보이는 지점입니다. 사진이 늘어나거나, 작성자가 예상하지 못한 레터박스가 생기거나, 설명이 그 설명하는 사진 위에 올라가거나, hero가 덮개가 너무 짙어 어두운 사각형으로 읽힙니다. 이 파일은 이 패키지가 따르는 기하 규칙과 그 이유를 적습니다.

## 1. 두 가지 조작

그림을 상자에 맞추는 방법은 두 가지뿐이고, 선택은 무엇을 잃어도 되는지의 문제입니다.

| 조작 | 지키는 것 | 잃는 것 | 쓰는 자리 |
|---|---|---|---|
| `contain` | 그림 전체 | 상자의 일부(여백) | 그림이 증거이고 잘리면 안 될 때, 예컨대 스크린샷 |
| `fill` | 상자 전체 | 그림의 일부(크롭) | 그림이 분위기나 질감일 때, 예컨대 hero 배경 |

두 가운데 결정 모두 같은 두 비율에서 나옵니다. 원본 비율 $R = w_s/h_s$와 상자 비율 $Q = W/H$입니다.

`contain`은 이렇게 됩니다.

$$w = \min(W,\; H \cdot R), \qquad h = w / R$$

`fill`의 크롭은 대칭이고 원본에 대한 백분율로 적습니다. `a:srcRect`가 받는 형식입니다.

$$c_l = c_r = \frac{1 - Q/R}{2} \times 100\%, \qquad c_t = c_b = 0 \quad (R > Q)$$

픽셀이 아니라 백분율이 중요한 이유는 `srcRect`가 원본의 1000분의 1 퍼센트 단위로 정의되기 때문입니다. 크롭을 거기에 적으면 파워포인트와 어떤 변환기든 같은 창을 보여 줍니다.

## 2. 크기는 파일에서 읽는다

패키지는 배치 전에 파일 헤더에서 픽셀 크기를 읽습니다. PNG는 `IHDR` 청크, JPEG는 첫 `SOFn` 표식입니다. 작성자가 적은 `aspect`는 파일을 읽을 수 없을 때만 쓰는 대비책입니다.

비율이 틀린 것은 미용상의 실수가 아닙니다. `contain`에서는 맞는 크롭을 잘못된 모양의 상자에 여백과 함께 넣고, `fill`에서는 사진의 엉뚱한 띠를 잘라 냅니다. 둘 다 고장 난 덱처럼 보이고, 둘 다 spec에서는 보이지 않습니다.

## 3. 캡션이 자기 자리를 먼저 비운다

사진 아래 설명은 자기 높이를 가진 실제 텍스트 도형입니다. 사진 높이는 설명 자리를 뺀 뒤에 계산하므로 설명이 위 사진을 덮을 수 없습니다. 갤러리에서 설명을 붙이면 사진이 작아지는 이유가 이것입니다. 설명이 자리를 먼저 가져갑니다.

## 4. 덮개

hero는 사진 위에 글자를 놓습니다. 사진 위의 글자는 복잡한 그림에서 반드시 실패하므로, 패키지는 고정 불투명도의 검정 판을 넣고 그 위에 글자를 최대 대비로 그립니다.

| `scrim` | 결과 |
|---|---|
| 0.35~0.45 | 밝은 사진, 글자는 짧고 커야 함 |
| 0.55(기본) | 대부분의 사진에서 안전 |
| 0.70 이상 | 거의 단색, 사진은 질감이 됨 |

규칙은 "그라디언트를 넣어라"가 아닙니다. 그라디언트 덮개는 자기 빛이 있는 사진 위에서 보이지 않고, 값을 읽어 확인할 수도 없습니다. 고정 불투명도는 따져 볼 수 있고 잴 수 있습니다.

## 5. 렌더가 확인하는 것

| 검사 | 조건 |
|---|---|
| `IMAGE_SMALL` | 320 × 180 미만 원본은 발표 화면에서 흐릿합니다 |
| `IMAGE_EXTREME` | 1:5 미만 비율은 어느 상자에서도 나쁘게 잘립니다 |
| `IMAGE_NO_ALT` | 대체 텍스트 없는 그림은 납품 결함입니다 |
| `IMAGE_REMOTE` | 원격 주소는 거부하며 덱이 네트워크에 기대지 않게 합니다 |
| `IMAGE_UNREADABLE` | 픽셀 크기를 읽을 수 없는 파일은 추측하지 않고 거부합니다 |

대체 텍스트는 그림에 `descr`로 적히며, 화면 읽기 프로그램이 읽는 값이고 그림이 로드되지 않을 때 읽는 사람이 보는 값입니다.

## 6. 버린 것

- **좌우 자동 선택.** 내용 유형으로 좌우를 정하는 것은 임의로 읽히는 추측입니다. 작성자가 방향을 정합니다.
- **도형 배경으로 자르기.** 일부 생성기는 그림을 도형 채우기로 넣고 텍스처 오프셋으로 맞춥니다. `p:pic`의 `srcRect`가 더 단순하고, 왕복 변환에서 살아남으며, 그림을 그림으로 남깁니다.
- **늘려 맞추기.** 비율과 무관하게 상자를 채우는 것은 생성한 덱의 가장 알아보기 쉬운 표식입니다.

## Sources

> 확인 2026-11-14.

| Claim | Source |
|---|---|
| `a:srcRect` 크롭은 원본에 대한 백분율로 표현됨 | <http://www.datypic.com/sc/ooxml/e-a_srcRect-1.html> |
| 그림 파트 구조와 `descr` 대체 텍스트 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |
| 원본 비율을 쓰는 contain과 cover 기하 | <https://github.com/hugohe3/ppt-master> |
| 생성 덱의 납품 요건으로서 대체 텍스트 | <https://github.com/microsoft/Resource2Skill> |
| 이미지 배치 파이프라인과 검토 규칙 | <https://github.com/eddyzzl/imagegen-pptx-pipeline> |

### 근거 등급

`LOCAL` - 기하는 `assets/runtime/layout.jq`에 구현했고 2026-11-14에 렌더한 슬라이드로 확인했습니다. `srcRect` 백분율은 산출물을 풀어 그림 XML을 읽어 확인했습니다. 발표 기준(320 × 180, 1: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: 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