Skip to content

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

hyper-hwp

Verified

Use this skill when the document to read, fill, edit, or produce is a Korean HWP or HWPX file - a .hwp/.hwpx report, 기안문, 공문서, 별지 서식, 신청서 with form fields, or a table that has to come out of one. It drives the rhwp CLI: read text and structure, extract tables and form fields, replace or insert text and table cells, fill fields, insert footnotes, scaffold a new document from a JSON spec, convert HWPX to HWP5, and gate the result with roundtrip and layout checks. Do not use for PDF, DOCX, XLSX, or PPTX files, Hangul word-processor automation through its own COM or UI, or scanned-image OCR.

rules/gongmunseo.ko.md

View on GitHub
# 공문서·기안문 관례

## 1. 언제 이 문서를 읽나

문서가 기안문, 공문서, 별지 서식, 계획서, 결과보고이거나 그렇게 보여야 할 때만 읽습니다. 일반 문서 편집에는 필요 없습니다.

## 2. 항목 번호 일곱 단계

행정기관 문서의 항목 구분 순서는 다음과 같습니다. rhwp의 `outline_numbering` 일곱 단계가 그대로 이 순서를 만듭니다.

| 단계 | 표기 | `num_format` | `text` 예 |
|---|---|---|---|
| 1 | 1., 2., 3. | `digit` | `^1.` |
| 2 | 가., 나., 다. | `hangul_syllable` | `^2.` |
| 3 | 1), 2), 3) | `digit` | `^3)` |
| 4 | 가), 나), 다. | `hangul_syllable` | `^4)` |
| 5 | (1), (2), (3) | `digit` | `(^5)` |
| 6 | (가), (나), (다) | `hangul_syllable` | `(^6)` |
| 7 | ①, ②, ③ | `circled_digit` | `^7` |

`text`는 번호 앞에 붙는 문자열 그대로입니다. 그래서 `"^1."`은 `1.갑`처럼 번호와 글자가 붙고, `"^1. "`(뒤에 공백)은 `1. 갑`이 됩니다. 실무 문서는 대체로 붙여 쓰므로 공백 없이 두는 편이 안전합니다.

일곱 단계를 넘기면 다시 1.로 돌아가므로, 여덟 번째 층이 필요하면 문서 구조를 다시 잡아야 하고 단계를 더 만들 일은 아닙니다.

## 3. 기안문의 뼈대

| 위치 | 내용 |
|---|---|
| 머리 | 시행일자, 시행번호, 접수일자, 접수번호, 우편번호, 주소, 전화번호, 문서번호 |
| 제목 | 사안을 한 줄로. 끝에 마침표를 찍지 않습니다 |
| 본문 | 항목 번호로 시작하고, 첫 항목은 보통 `…하고자 함`으로 끝나는 목적 문장입니다 |
| 붙임 | `붙임` 뒤에 쌍점을 찍지 않고 두 칸 띄운 뒤 목록. `끝.`으로 닫습니다 |
| 발신 | 기관명과 직위, 직인 자리 |

본문 첫 줄에 목적과 결론을 먼저 씁니다. 배경은 사실로 엽니다. 지시 일자, 법령 시행일, 민원 건수가 그 사실입니다. "급변하는 행정환경에 따라" 같은 분위기 문장으로 열지 않습니다.

## 4. 표기 규칙

| 항목 | 규칙 | 예 |
|---|---|---|
| 날짜 | 온점과 숫자 사이를 띄우고, 월·일의 0을 쓰지 않으며, 일 뒤에 마침표 | `2026. 11. 13.` |
| 시간 | 24시각제, 시와 분 사이 쌍점은 붙여 씀 | `09:00`, `15:30` |
| 금액 | 아라비아 숫자와 쉼표, 단위는 붙여 씀. '천원'으로 줄이지 않음 | `345,000원` |
| 범위 | 물결표와 '까지'를 함께 쓰지 않음 | `2026. 2. 20.∼2. 24.` |
| 쌍점 | 앞말에 붙이고 뒤를 한 칸 띄움 | `원장: 김갑동` |
| 외국어 병기 | 한글을 먼저 쓰고 괄호 안에 원어 | `업무 협약(MOU)` |

## 5. 표

- 표는 항목이 셋 이상이고 서로 비교해야 할 때만 씁니다. 두 항목이면 문장으로 씁니다.
- 머리행은 굵게, 단위는 머리행에 적고 셀마다 반복하지 않습니다.
- 숫자는 오른쪽 정렬, 글자는 왼쪽 정렬입니다. rhwp의 `cell_align`은 `"left"`, `"center"`, `"right"`를 셀 단위 배열로도 받습니다.
- 합계 행이 있으면 다른 행과 구분선을 둡니다.

## 6. 각주

- 각주는 본문 흐름을 끊지 않고 근거를 붙일 때 씁니다. 출처, 법령 조항, 계산 근거가 여기에 해당합니다.
- rhwp에서 각주는 `edit insert-footnote`로 자리를 만들고 `edit insert-footnote-text`로 본문을 넣습니다. 두 명령이 한 쌍입니다.
- 각주 번호는 문서가 매기므로 본문에서 번호를 직접 쓰지 않습니다.

## 7. 문체

- 개조식은 명사형으로 끝냅니다(`… 추진`, `… 완료`). 서술식은 `…한다`로 끝냅니다. 한 문서에서 섞지 않습니다.
- 한 문단에 한 가지 사실만 담습니다.
- 근거 없는 수치를 만들지 않습니다. 모르면 `○○건`, `2026. ○. ○.` 자리표시로 두고 채울 항목으로 남깁니다.
- "체감도 제고", "만족도 향상"처럼 지표 없는 마무리 대신 목표치를 적습니다(`민원 연 412건 → 200건`).

## 8. rhwp로 만들 때의 실무

1. 일곱 단계가 필요하면 `scaffold` 명세의 `outline_numbering`에 일곱 항목을 넣고 블록의 `level`로 단계를 고릅니다.
2. 표는 `scaffold` 명세의 `table` 블록으로 만들고, 나중에 값이 바뀌면 다시 만들지 말고 `edit set-cell`로 그 칸만 고칩니다.
3. 붙임 목록은 `paragraph` 블록으로 씁니다. 도구가 `붙임`이나 `끝.`을 대신 붙여 주지 않습니다.
4. 각주가 필요하면 scaffold로 만든 뒤 `insert-footnote`와 `insert-footnote-text`를 그 순서대로 돌립니다.
5. 표 모양도 고칠 수 있습니다. `set-column-widths`, `merge-cells`, `split-cell`, `insert-row`·`insert-col`, `set-cell-props`가 모두 동작합니다. 다만 속성 JSON은 스키마 검사가 없으므로 속성을 바꾼 뒤 폭을 다시 읽거나 쪽을 다시 그려 확인합니다. 종료 코드 0은 명령이 돌았다는 뜻일 뿐입니다(`rules/rhwp-command-map.md` 8절).

## Sources

> 확인 2026-11-13. 항목 번호와 표기 규칙은 2차 출처를 따랐고, law.go.kr 원문에는 이 환경에서 접속하지 못했습니다(302 리다이렉트).

- 항목 구분 일곱 단계와 표기 규칙: 행정안전부 「행정업무의 운영 및 혁신에 관한 규정 시행규칙」 별지 제1호서식. <https://github.com/jkf87/hwpx-skill/blob/main/references/gonmunseo-2025-writing-rules.md>에 재수록된 내용
- 문서 구성(왜 → 무엇을 → 어떻게)과 금지 표현: <https://github.com/chrisryugj/kordoc> 의 `.claude/` 아래 gongmunseo 참고자료
- 일곱 단계 실제 출력: rhwp v0.9.0 `scaffold`로 `digit`·`hangul_syllable`·`circled_digit`을 섞어 만든 문서를 `export-text`로 읽어 확인
- `cell_align` 값: `src/scaffold/schema.rs` (<https://github.com/edwardkim/rhwp>)
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