Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-docx

hyper-docx

Verified

Use this skill when the deliverable is a Word document: create a .docx, edit or restyle one, review it with tracked changes and comments, or check that a generated file opens and lays out as intended. It builds the package from a declarative JSON spec, reads an existing package part by part, applies Korean document conventions (item hierarchy, body size and line spacing, margins, 붙임/끝), records edits as revisions, and verifies the result structurally and visually. Do not use for Google Docs or Hangul (.hwp/.hwpx) files, PDF-only output, spreadsheet or slide formats, or prose that is never rendered into a document.

rules/korean-document.ko.md

View on GitHub
# 한국어 문서 관례

한국어 독자가 공문서·보고서·계약서에서 기대하는 것과 그 수치의 출처입니다. 여기 있는 값은 모두 사용자가 덮어쓸 수 있는 기본값이고, 법령 인용이 아닙니다.

## 1. 이 수치의 정직한 지위

한국 공문서에서 실제로 쓰는 판형(A4, 본문 15포인트, 줄 간격 200퍼센트, 위아래 15밀리미터, 좌우 20밀리미터)은 공문서 작성 안내서와 사무용 서식에 퍼진 관행입니다. 이 값을 적은 별표(행정업무 운영 규정 시행규칙의 서식의 설계 기준)는 2026-11-13에 원문을 읽지 못했습니다. law.go.kr가 그날 21시부터 다음 날 21시까지 시스템 점검 중이었습니다. 그러니 이 프리셋은 **산업 관행이고 검증된 법령 인용이 아니며**, 사용자가 규정이 맞는지 물으면 그렇게 답합니다. 수치가 계약상 중요하면 law.go.kr에서 현행 별표를 읽고 스펙의 `margin_mm`, `size_pt`, `line_pct`를 덮어씁니다.

프리셋이 정하는 값입니다.

| 설정 | 값 | 스펙 키 |
|---|---|---|
| 용지 | A4, 210 × 297 밀리미터 | `page: "official-kr"` |
| 여백 | 위 15, 아래 15, 왼쪽 20, 오른쪽 20 밀리미터. 머리글·바닥글 10밀리미터 | `margin_mm` |
| 본문 글꼴 | 휴먼명조 | `font` |
| 본문 크기 | 15포인트 | `size_pt` |
| 줄 간격 | 단일 간격의 200퍼센트 | `line_pct` |
| 정렬 | 본문 양쪽 정렬, 제목 가운데, 바닥글 페이지 번호 | 자동 |

## 2. 항목 계층

한국어 문서는 정해진 기호 순서로 깊이를 표시합니다. 번호를 다시 매기거나 순서를 바꾸지 않습니다.

```
1.        level 1   번호
 가.      level 2   가지번호
 1)       level 3   괄호번호
 가)      level 4   괄호가지번호
 (1)      level 5   괄호아라비아
 (가)     level 6   괄호한글
 ①        level 7   원문자
```

스펙에서는 `{"type": "item", "mark": "가.", "text": "..."}`처럼 기호를 직접 넘깁니다. 들여쓰기로 계층을 추측하지 않습니다. 잘못 추측하면 문서 번호가 조용히 달라지기 때문입니다. 기호 뒤 본문이 나란히 서도록 `left_mm`과 `hanging_mm`을 정합니다. 내어쓰기 5밀리미터에 왼쪽 들여쓰기 5~10밀리미터면 2·3계층이 읽기 좋습니다.

문단 안에서 문장을 시작하는 숫자(`1. 점검 개요`)는 목록 항목이 아니라 일반 텍스트입니다. 그 숫자는 도구의 번호가 아니라 문서 자체의 순서를 나타냅니다.

## 3. 문서 장식

| 요소 | 관례 | 방법 |
|---|---|---|
| 제목 | 가운데, 굵게, 본문보다 크게. 끝에 마침표를 붙이지 않음 | `{"type":"title"}` |
| 두문(발신 명의, 시행일) | 첫 쪽 맨 위, 제목 앞 | `title` 앞의 일반 문단 |
| 붙임 | 본문 뒤, `붙임` 다음에 건수(`붙임  세부 점검표 1부.`) | `{"type":"row","text":"붙임","value":"세부 점검표 1부."}` 또는 일반 텍스트 |
| 끝 | 마지막 줄 끝에 종결 표시 `...  끝.` | 마지막 문단 텍스트에 `끝.` 앞 두 칸 공백 |
| 페이지 번호 | 가운데 바닥글, `- 1 / 3` | `footer: true` |
| 시행일·접수 | 띄어 쓴 날짜 형식 `2026. 11. 13.` | 그대로 적은 텍스트 |

`끝.` 표시는 마지막 내용 줄과 같은 문단에 둡니다. 따로 줄을 만들지 않습니다. 문서의 끝을 눈에 보이게 하는 표시라서 위치가 어긋나면 독자가 알아챕니다.

## 4. 숫자, 날짜, 단위

- 날짜는 `2026. 11. 13.`처럼 각 부분 뒤에 마침표를 찍고 가운뎃점 뒤에 띄어 씁니다.
- 범위는 원문이 `~`를 쓸 때만 같이 쓰고, 본문에서는 `부터 … 까지`를 씁니다.
- 금액은 `12,000원`처럼 천 단위로 끊고 단위 앞에 띄지 않습니다.
- 백분율은 `15%`처럼 띄지 않습니다.
- 단위는 숫자와 띄되 `%`와 `°`는 붙입니다. `15 mm`, `3 kg`, `15%`.
- 표에서 음수와 범위는 셀마다 단위를 붙이지 않고 머리글 행에 단위를 둡니다(`금액(원)`).

## 5. 표

| 규칙 | 이유 |
|---|---|
| 머리글 행은 `E7E6E6` 음영, 굵게, 가운데 | 긴 표에서 머리글과 데이터를 구분 |
| 표가 페이지를 넘으면 머리글 행을 반복 | 첫 행의 `w:tblHeader`. 빌더가 설정 |
| 열 폭을 밀리미터나 트윕으로 명시 | 백분율 폭은 워드·Pages·미리보기에서 다르게 그려짐 |
| `TableGrid` 스타일에 `tblBorders`를 직접 함께 지정 | 스타일만 있으면 일부 미리보기가 테두리를 버림 |
| 단위는 셀이 아니라 머리글에 | 셀이 짧아지고 정렬이 깔끔해짐 |
| 요청에 필요할 때만 중첩 표 | 중첩은 독자의 위치 감각을 잃게 함 |

표 안 본문은 본문 기본값보다 작게 잡습니다. 15포인트 본문에는 10.5~11포인트가 맞습니다. 표마다 `font_size`를 정합니다.

## 6. 글꼴과 대체

`휴먼명조`는 한국 사무용 설치본에 들어 있고 macOS나 Linux에는 없습니다. 패키지는 그래도 그 이름을 적고, 없으면 읽는 쪽 기계가 대체합니다. 결과는 두 가지입니다.

- 이 기계에서 렌더한 증거에는 대체 글꼴 모양이 찍히므로 글꼴 *모양*은 여기서 검증할 수 없습니다. 확인 가능한 것은 크기, 굵기, 간격, 기하입니다.
- 모든 런에 `w:eastAsia`와 `w:hint="eastAsia"`를 지정합니다. 이 힌트가 없으면 라틴 우선 글꼴 선택이 한글 글리프를 차지해 읽는 사람마다 본문 모양이 달라집니다.

어디서든 똑같이 보여야 하는 문서라면 대상 환경에 있는 글꼴(`맑은 고딕`, `바탕`, `Noto Serif KR`)을 적고 그 이유를 함께 적습니다.

## 7. 요청이 비어 있을 때

프리셋을 적용하고, 전달 요약에 이 배치가 공문서 관행을 따른다고 적습니다. 조용한 기본값을 사용자의 취향으로 제시하지 않고, 프리셋이 이미 답하는 것을 질문으로 만들지 않습니다.

## Sources

> Checked 2026-11-13

- law.go.kr 행정규칙 서비스, 서식의 설계 기준을 적은 시행규칙 별표 — https://www.law.go.kr/ (2026-11-13 점검 시간에 접속 불가. 프리셋을 인용이 아닌 관행으로 처리)
- ECMA-376 WordprocessingML, 런 글꼴과 eastAsia 힌트, 표 속성 — https://ecma-international.org/publications-and-standards/standards/ecma-376/
- Microsoft Learn, WordprocessingML의 머리글 행 반복과 셀 음영 — https://learn.microsoft.com/en-us/office/open-xml/word/
- 공문서 항목 구분 기호 관행(1. / 가. / 1) / 가) / (1) / (가) / ①). 공문서 작성 안내서 전반에서 사용
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