hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-pptx
hyper-pptx
VerifiedUse 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.
rules/layout-and-typography.ko.md
View on GitHub# 레이아웃과 활자
슬라이드가 빽빽할 때, 활자가 이상해 보일 때, 방 뒤에서도 읽혀야 할 때 이 규칙 파일을 사용합니다. 좌표는 `assets/runtime/layout.jq`에 있고, 이 파일은 작성자가 그 안에서 해야 할 판단을 설명합니다.
## 1. 격자
| 값 | EMU | 인치 |
|---|---|---|
| 슬라이드 | 12192000 × 6858000 | 13.333 × 7.5 |
| 여백 | 609600 | 0.667 |
| 본문 폭 | 10972800 | 12.0 |
| 제목 영역 | y 533400, 높이 838200 | 0.583, 0.917 |
| 본문 시작 | y 1600200 | 1.75 |
| 본문 끝 | y 6248400 | 6.833 |
| 바닥글 | y 6355080 | 6.95 |
왼쪽 끝은 카드와 표까지 모두 같은 여백을 씁니다. 이미지 슬라이드를 뺀 나머지는 가로 가운데 정렬을 하지 않습니다. 제목 왼쪽 끝과 맞지 않는 가운데 열은 실수로 읽힙니다.
## 2. 활자 크기
| 역할 | 포인트 | 이유 |
|---|---|---|
| 표지 제목 | 44 | 덱에서 유일하게 40포인트를 넘는 요소 |
| 장 번호 | 15, 강조색 | 제목이 아니라 이름표 |
| 장 제목 | 36 | |
| 슬라이드 제목 | 30 | 한 줄, 한국어 약 20자 |
| 도입 문장 | 17 | 제목 아래 한 문장 |
| 본문 | 18~22, 블록에 맞춰 키움 | 방에서 읽히는 크기, 30포인트 제목 아래로 제한 |
| 하위 항목 | 16 | 본문에서 2포인트 뺀 값 |
| 카드 제목 | 17, 강조색 | |
| 카드 항목 | 15 | |
| 숫자 값 | 46 | |
| 숫자 이름표 | 15 | |
| 숫자 설명 | 12, 보조색 | |
| 표 | 13 | |
| 캡션 | 12, 보조색 | |
| 인용 | 32 | |
| 한 문장(`statement`) | 길이에 따라 40 / 34 / 28 | 어두운 페이지에서 가장 큰 요소 |
| 큰 숫자(`bigstat`) 값 | 길이에 따라 150 / 120 / 96 / 72 | 아홉 글자까지, 숫자 하나가 주장 |
| 큰 숫자 이름표 | 22 | 그 숫자가 무엇인지 말하는 문장 |
| 단계 제목(`process`) | 18~20 | 네 단계부터 18로 내려 다섯 열도 들어감 |
| 단계 본문 | 15 | |
| 바닥글과 쪽 번호 | 11, 보조색 | |
규칙이 둘 따라옵니다. 본문은 15포인트보다 작게 쓰지 않습니다. 그 아래로 내려가면 프로젝터에서 글자가 결이 됩니다. 강조는 크기가 아니라 굵기와 색으로 만듭니다. 30포인트 제목과 18포인트 본문이면 충분히 갈리므로, 24포인트짜리 "중요" 항목은 일관성만 깨뜨립니다.
글머리 슬라이드는 본문 영역에 맞춰 글자를 키우되 넘기지 않습니다. 18, 19, 20, 21, 22포인트를 차례로 시도해 영역에 들어가는 가장 큰 크기를 씁니다. 상한은 22포인트(`T_BODY_MAX`)라서, 항목이 네 개인 슬라이드에서도 본문이 제목의 3분의 2를 넘지 않습니다. 그래도 자리가 남으면 남은 높이를 문단 사이 여백으로 나눠 넣습니다. 문단당 최대 18포인트이며, 페이지 아래에 빈 띠 하나로 남기지 않습니다.
## 3. 여백
- `spaceBefore`는 포인트이고 기본값 6은 문단 사이 여백입니다. 줄 간격은 아닙니다. 줄 간격은 읽는 사람과 글꼴에 맡깁니다.
- 카드와 숫자는 304800 EMU(0.333인치) 간격을 씁니다. 더 벌리면 한 줄이 따로 노는 물건으로 갈라지고, 좁히면 하나로 뭉칩니다.
- 도입 문장은 본문을 640080 EMU 아래로 밉니다. 첫 항목에 여백을 더 얹지 않습니다. 배치가 이미 상자를 옮겼습니다. 본문에서 가운데로 오는 블록은 도입 문장 아래 남은 자리에서 가운데로 오므로, 도입 문장이 소개하는 내용에 붙어 있습니다.
- 세로 가운데 정렬은 한 줄짜리 상자에만 씁니다. 여러 줄 상자를 가운데로 고정하면 글자를 고칠 때 위치가 움직여, 같은 슬라이드의 두 판이 달라 보입니다. 본문 안에서 가운데로 오는 블록은 제목이나 도입 문장에서 640080 EMU 아래까지만 내려옵니다. 그보다 벌어지면 블록이 제목의 근거가 아니라 따로 놓인 페이지로 읽힙니다. 타임라인은 예외입니다. 폭을 채우는 띠는 높이 가운데에 있어야 위아래 여백이 맞습니다.
- 카드 높이는 가장 긴 열이 필요로 하는 만큼 씁니다. 제목, 줄바꿈된 항목, 위아래 여백을 더해 정하고, 짧은 카드 셋이 제목 아래 띠로 주저앉지 않도록 본문 높이의 62%를 최소로 둡니다. 제목과 항목은 카드 안에서 세로 가운데에 놓이므로 남는 높이는 여백으로 읽히고 빈 판으로 남지 않습니다. 줄 전체는 리드 줄 아래 남은 자리의 가운데에 놓아 위아래 여백을 맞춥니다. 본문에 들어가지 않는 줄은 잘리지 않고 `LAYOUT_OVERFLOW`로 보고됩니다.
## 4. 색
- 덱마다 강조색 하나를 씁니다. 슬라이드마다 눈이 먼저 닿아야 할 한 곳을 표시합니다. 숫자 값, 카드 제목, 표 머리, 차트 첫 계열입니다.
- 보조색은 받쳐 주는 글자에 씁니다. 캡션, 노트, 바닥글, 하위 항목입니다. 주장에는 쓰지 않습니다.
- 어두운 슬라이드(표지, 장, 인용)는 팔레트의 어두운 토큰을 씁니다. 밝은 본문색을 어두운 배경에 얹으면 상태 나쁜 프로젝터에서 글자가 사라집니다.
- 대비는 본문이 4.5:1 이상, 큰 글씨가 3:1 이상입니다. `ink`와 `mono` 팔레트는 이 기준을 넘습니다. 직접 지정한 `accent`는 글자색으로 쓰기 전에 확인해야 합니다.
## 5. 색 블록, 그라디언트, 장식
- `accent2`는 두 번째 강조가 아니라 짝입니다. 차트의 두 번째 계열, 세 번째부터 다섯 번째 단계의 배지, 주 강조 옆의 블록 하나에 씁니다. 한 슬라이드에서 눈을 끄는 색 둘은 하나가 많은 것이므로, 페이지마다 주인공 색을 하나 정합니다.
- 그라디언트는 배경 전체가 아니라 띠입니다. 실제로는 글자 뒤 도형 하나에 각도 `0`이나 `90`, 같은 팔레트의 색 둘입니다. 본문 뒤에 화면 전체 그라디언트를 깔면 페이지 한쪽 끝에서 대비가 떨어지고, 떨어지는 쪽은 작성자가 확인하지 않은 쪽입니다.
- 장식은 뒤에 있고 조용합니다. 띠, 가는 선, 가장자리 블록입니다. 내용으로 읽히는 것은 역할과 캡션을 갖고, 장식으로 읽히는 것은 `role: "decor"`를 받아 `target: "all"`에서 빠집니다.
- 어두운 슬라이드는 팔레트를 지킵니다. `darkSurface`와 `darkAccent`가 있는 이유는 색을 쓴 덱이 표지와 장 구분에서 회색으로 떨어지지 않게 하려는 것입니다. `bg`를 덮어쓰고 어두운 토큰은 팔레트에서 받는 것이 보통입니다.
- 한 페이지에 화면 폭 요소는 하나입니다. 색 블록과 그라디언트 띠와 강조 선은 함께 있을 수 있지만, 폭을 다투는 큰 블록 둘은 페이지를 줄무늬로 만듭니다.
## 6. 모션
- 모션은 읽는 순서이지 장식이 아닙니다. 제목, 본문, 차트 순서로 등장하면 발표장이 어디를 봐야 하는지 알려 줍니다. 모든 요소가 한꺼번에 움직이면 아무것도 움직이지 않은 것과 같고, 다만 느립니다.
- `target: "all"`이 장식을 건너뛰는 것은 의도입니다. 제목 아래 규칙선이 페이드 인 하면 페이지가 스스로 조립되는 것처럼 보입니다.
- `with-previous`는 함께 읽어야 하는 것을 묶고, `after-previous`는 목록을 띄워 앞 항목 다음에 하나씩 떨어뜨립니다. 이유 없이 한 흐름에서 둘을 섞지 않습니다. 청중은 클릭이 페이지를 넘겼는지 시간이 넘겼는지 알 수 없습니다.
- 전환은 장 경계입니다. 덱 전체에 한 효과를 쓰거나, 장 구분에만 하나 쓰고 나머지는 비웁니다. 슬라이드마다 다른 전환은 사고처럼 읽힙니다.
- 길이는 400~700밀리초입니다. 400 아래면 눈이 움직임을 놓쳐 깜빡임으로 읽히고, 800을 넘으면 발표장이 페이지를 기다립니다.
- 한 문장 페이지와 큰 숫자 페이지는 이미 내용이 페이지 전체입니다. 배경이 아니라 숫자를 움직입니다. 띠가 가만히 있으면 페이지가 흔들리지 않습니다.
## 7. 표와 차트
- 표는 머리 행을 강조색으로 채우고 본문 행을 표면색으로 번갈아 칠합니다. 열은 여섯 개까지입니다. 열 폭이 같으므로 긴 문장이 들어간 열은 줄바꿈되고 행 높이를 밀어냅니다.
- 행 높이는 본문 영역을 행 수로 나눈 값이며 0.35~0.8인치로 자릅니다. 0.35 하한이 이기기 시작하는 것은 머리를 포함해 15행(캡션이 있으면 14행)이고, 그때부터 표가 본문 아래로 넘치며 렌더러가 넘침으로 보고합니다. 그 전에 표를 나눕니다.
- 차트는 첫 계열이 강조색을 갖고 나머지는 보조색, 선색, 표면색으로 밀립니다. 조각이 다섯을 넘는 원형 차트는 읽히지 않습니다. 막대 차트로 바꿉니다.
- 차트 값은 숫자여야 합니다. 문자열로 넣으면 범주 이름으로 그려지고 조용히 평평한 차트가 됩니다.
- 한 장에 단위가 둘이면 `combo`를 씁니다. 막대는 왼쪽 축을, 선은 눈금선이 없는 오른쪽 보조 축을 읽습니다. 비율과 부피를 한 축에 놓으면 비율이 기준선에 납작해져 0으로 읽힙니다.
- 가로 차트는 범주 이름이 길 때 씁니다. 세로 차트는 이름표를 돌려 세웁니다. 누적 차트는 합계에 의미가 있을 때만 구성을 보여 줍니다.
- 산점도의 범주는 숫자로 읽히면 x가 됩니다. 값을 두 축에 함께 쓰지 않습니다. 원점을 지나는 대각선이 그려집니다.
## 8. 이미지
- `fit`이 무엇을 잃을지 정합니다. `contain`은 그림 전체를 지키고 상자에 여백을 남기므로 스크린샷처럼 그림이 증거일 때 맞습니다. `fill`은 상자를 지키고 가운데를 `srcRect`로 잘라 내므로 질감과 `hero`에 맞습니다.
- `aspect`는 파일 크기를 읽을 수 없을 때만 적습니다. 배치는 파일 헤더에서 픽셀 크기를 먼저 읽으므로, 값이 틀리면 엉뚱한 띠를 자르거나 맞는 크롭에 여백을 붙입니다.
- 모든 그림은 `alt`를 가집니다. `descr`로 적히고 화면 읽기 프로그램이 읽으며 그림이 로드되지 않을 때 보입니다. 없으면 `IMAGE_NO_ALT`로 보고합니다.
- 캡션은 그림 높이 위에서 자기 자리를 먼저 비우므로 설명하는 사진을 덮을 수 없습니다.
- `gallery`는 사진 1~4장을 받고 각 사진 아래에 설명을 답니다. 글 단락 옆에 사진 둘은 배치 문제이지 사진 문제가 아닙니다. 하나면 `imagetext`, 여러 장이면 `gallery`를 씁니다.
- 글자 아래 사진에는 고정 덮개를 깝니다. 기본 `0.55`이고 복잡한 사진은 올리고 어두운 사진은 내립니다. 그라디언트 덮개는 자기 빛이 있는 사진 위에서 보이지 않고 값을 읽어 확인할 수도 없습니다.
## 9. 전달 전에 확인할 것
- 제목이 한 줄인지. 줄바꿈됐으면 활자를 줄이지 말고 제목을 줄입니다.
- 본문 폭을 넘는 항목이 없는지, 잘려서 말줄임이 붙은 항목이 없는지.
- 캡션이 가리키는 대상 바로 아래에 있는지. 다음 대상 아래에 있지 않은지.
- 표지 슬라이드를 뺀 모든 슬라이드에 바닥글이 있고 쪽 번호가 맞는지.
- 모션이 있는 덱이라면 슬라이드마다 처음 움직이는 요소가 읽는 사람이 처음 읽어야 할 요소이고, 장식을 움직이는 페이지가 없는지.
## Sources
> 확인 2026-11-13.
| Claim | Source |
|---|---|
| 슬라이드 크기, EMU, 16:9 좌표 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/structure-of-a-presentationml-document> |
| 글자 대비 기준 | <https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html> |
| 투사되는 글자의 크기와 줄 길이 | <https://www.w3.org/WAI/tutorials/images/complex/> |
| 차트 계열 색 배정과 값 캐시 | <https://learn.microsoft.com/en-us/office/open-xml/presentation/working-with-charts> |
| 선형 그라디언트와 각도 규칙 | <https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.drawing.gradientfill> |
### 근거 등급
`LOCAL` - 격자, 활자 크기, 하한값은 `assets/runtime/layout.jq`에서 읽었고 2026-11-13과 2026-11-14에 슬라이드마다 렌더링해 확인했습니다. 대비 하한은 WCAG 2.2 최소 기준입니다. 모션 지침은 편집 판단이며 길이는 프로젝터에서 재지 않았습니다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |