hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-pdf
hyper-pdf
VerifiedUse this skill when the user asks to read, extract from, or produce a PDF - text, tables, images, metadata, form fields, OCR of a scan, merge, split, rotate, watermark, encrypt, or a Korean contract, invoice, or report - and wants the result verified rather than assumed. Two generation paths with an explicit routing rule, a zero-dependency macOS runtime, and checks for font embedding, language tag, and structure tree. Do not use for Word or HWP documents, screenshots, slide decks, or numeric charts.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 14.9 KB |
| SKILL.md | skill md | 14.3 KB |
| assets/evals/hyper-pdf-cases.jsonl | other | 14.2 KB |
| assets/runtime/compose.js | script | 13.0 KB |
| assets/runtime/engine.js | script | 32.2 KB |
| assets/runtime/native.js | script | 35.4 KB |
| references/commands.ko.md | markdown | 9.9 KB |
| references/commands.md | markdown | 9.5 KB |
| references/layout-spec.ko.md | markdown | 8.2 KB |
| references/layout-spec.md | markdown | 7.6 KB |
| rules/accessibility.ko.md | markdown | 5.3 KB |
| rules/accessibility.md | markdown | 4.9 KB |
| rules/extraction.ko.md | markdown | 6.1 KB |
| rules/extraction.md | markdown | 5.6 KB |
| rules/html-to-pdf.ko.md | markdown | 6.6 KB |
| rules/html-to-pdf.md | markdown | 6.1 KB |
| rules/korean-typesetting.ko.md | markdown | 5.8 KB |
| rules/korean-typesetting.md | markdown | 5.5 KB |
| rules/ocr.ko.md | markdown | 4.0 KB |
| rules/ocr.md | markdown | 3.7 KB |
| rules/research-notes.ko.md | markdown | 8.1 KB |
| rules/research-notes.md | markdown | 7.9 KB |
| rules/verification.ko.md | markdown | 3.9 KB |
| rules/verification.md | markdown | 3.8 KB |
rules/verification.ko.md
View on GitHub# 인도 전 검증
> 만든 PDF는 주장입니다. 쪽 이미지, 바이트 검사, 추출 텍스트가 그 주장을 증거로 바꾸는 세 검사입니다.
## 1. 관문
만든 문서는 모두 아래 세 검사를 이 순서로 통과합니다. 하나를 건너뛰면 보고의 결함이고 지름길이 아닙니다.
| 단계 | 명령 | 증명하는 것 |
|---|---|---|
| 구조 | `check <out.pdf>` | 글꼴이 임베딩됐고 언어 태그가 있고 빈 쪽이 없으며 스캔이 표시됨 |
| 기하 | `info <out.pdf>` | 쪽 수·쪽 크기·회전·메타데이터가 의도한 값 |
| 겉모습 | `render <out.pdf> --out-dir DIR` | 쪽이 실제로 서술한 문서처럼 보임 |
텍스트가 중요한 문서에는 네 번째가 붙습니다.
| 단계 | 명령 | 증명하는 것 |
|---|---|---|
| 판독 | `text <out.pdf>` | 그린 문자열이 올바른 문자 체계로 추출됨 |
## 2. `check` 결과 읽기
| `status` | 할 일 |
|---|---|
| `ok` | 결과와 실행한 검사를 보고 |
| `caveated` | `issues[]` 코드마다 그 손실을 붙여 보고. 파일을 끝났다고 하지 않음 |
| `blocked` / `error` | 아무것도 만들어지지 않음. 코드와 필요한 것을 보고 |
`build` 경로의 `NO_STRUCTURE_TREE`는 예상된 결과입니다. 그래도 한 줄로 적을 한계입니다. 화면 낭독기가 그 파일에서 읽기 순서를 복원하지 못합니다. 숨기지도 말고 접근성 있다고 표현하지도 마세요.
## 3. 렌더가 잡는 것
바이트 검사로는 안 보이고, 모두 실제 문서에서 나간 적이 있는 결함입니다.
| 결함 | 이미지에서의 흔적 |
|---|---|
| 좌우·상하 반전 | 글자가 오른쪽에서 왼쪽으로, 또는 거꾸로 읽힘 |
| 베이스라인 오류 | 위 괘선에 겹치거나 여백에 떠 있음 |
| 머리글 반복 누락 | 표가 이어지는 둘째 쪽에 열 이름이 없음 |
| 여백 침범 | 텍스트나 표 끝이 여백을 넘음 |
| 대체 글꼴 | 문단 중간 한 단어만 눈에 띄게 다른 글꼴 |
| 한국어 줄바꿈 결함 | 줄이 `,`나 `)`로 시작 |
| 쪽 번호 누락 | 여러 쪽 문서인데 바닥글 영역이 빔 |
| 빈 마지막 쪽 | 마지막 쪽에 내용이 없음 |
| 셀 잘림 | 줄바꿈되지 않고 열 경계에서 글자가 잘림 |
## 4. 보고에 남길 증거
- 출력 경로, 쪽 수, mm 단위 쪽 크기.
- `check` 상태와 모든 이슈 코드.
- 렌더해 확인한 쪽과 본 내용.
- 정확한 명령줄. 결과를 재현할 수 있어야 함.
- 실행하지 않은 검사와 그 이유. 실행하지 않은 검사는 미실행으로 보고하고 통과로 적지 않음.
## 5. 한계 보고
사과가 아니라 산출물의 성질로 적습니다.
- "구조 트리가 없어 화면 낭독기가 읽기 순서를 복원하지 못합니다."
- "글꼴이 임베딩되지 않아 이 글꼴이 없는 기기에서는 대체 글꼴로 다시 배치됩니다."
- "OCR 정확도는 확인하지 않았습니다. 3쪽 이미지를 직접 확인해 주세요."
## 6. 검증을 건너뛰어 달라는 요청
파일은 만들고, 건너뛴 것과 그로 인해 남는 위험을 보고합니다. 사용자의 지시는 작업을 정하지 보고의 정확성을 정하지 않습니다. 아무것도 확인하지 않았는데 "검증했다"고 적는 보고는 누가 속도를 요구했든 거짓입니다.
## Sources
> Checked 2026-11-13.
| Claim | Source |
|---|---|
| 글꼴 임베딩 요구와 대체 동작 | <https://pdfa.org/resource/pdfa-2/> (ISO 19005-2) |
| 구조 트리와 읽기 순서 | <https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf> (§14.8) |
| 한국어 줄 머리 금지 문자 | <https://www.w3.org/TR/klreq/> |
| 시각 검토를 위한 쪽 렌더 | <https://developer.apple.com/documentation/pdfkit/pdfpage> |
### Evidence grade
검사 순서, 결함 흔적, 코드는 모두 이 기기에서 만든 문서에서 관찰한 `LOCAL`입니다. 표준 주장은 `SPEC`입니다.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: 197k | 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: 197k | 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: 197k | 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: 197k | Updated | Claude CodeCodex | Verified | Install |