Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/airmang/hwpx-plugins/hwpxnpx skills add airmang/hwpx-plugins --skill hwpxgit clone --depth 1 https://github.com/airmang/hwpx-pluginsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/airmang/hwpx-plugins/hwpx)<a href="https://agentmods.dev/skills/airmang/hwpx-plugins/hwpx"><img src="https://agentmods.dev/badge/skills/airmang/hwpx-plugins/hwpx.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00173 | $0.06567 |
| Opus 5 | $0.00086 | $0.03284 |
| Sonnet 5 | $0.00035 | $0.01313 |
| Haiku 4.5 | $0.00017 | $0.00657 |
Grade A, and why
hwpx scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
100% identical to hwpx — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 205 lines — stays where its author put it; the contents beside it link to each section on GitHub.
hwpx (HWPX / OWPML)
.hwpx는 ZIP 기반 OWPML 문서다. 모든 작업은
python-hwpx-automation의 MCP 도구를 1차 경로로 사용한다. 새 설정은 정식
host-local key hwpx, launcher scripts/hwpx-automation-mcp, 콘솔
hwpx-automation-mcp를 사용한다. hwpx-mcp-server 이름과 launcher wrapper는
6.x 호환 표면이며 host key는 MCP 프로토콜 식별자가 아니다.
MCP가 없을 때의 local Python(python-hwpx >= 6.3.0) 대안과 번들 스크립트는 references 문서에만 있다.
일반적인 읽기·편집·양식 채움·문서 생성처럼 여러 단계를 거치는 작업은 서버가 상태와 안전 정책을
강제하는 start_workflow를 1차 경로로 쓴다. get_workflow·continue_workflow로 진행하고,
decision에서만 approve_workflow_decision을 호출한다. 중단·재개는 cancel_workflow·resume_workflow를
쓴다. 큰 결과의 resultRef는 get_workflow_result로 회수한다. typed 입력과 영수증 계약은
workflows-autonomous를 본다.
primitive 도구는 workflow가 지원하지 않는 전문 작업 또는 진단용 escape hatch다. 단, 처음 보는
기존 문서의 semantic 구조를 탐색하고 본문·표 셀·기존 단순 머리글 story 또는 블록 이동·복사를
포함한 이종 편집을 한 번에 적용하는 요청은
get_document_node → query_document_nodes → apply_document_commands 경로를 쓴다.
지원되는 문서·하위 트리를 다른 HWPX로 이식할 때는 같은 경로로 source/target canonical path를
확정한 뒤 dump_document_blueprint → manifest의 unsupported/fidelity 검토 →
replay_document_blueprint(dry-run → commit)를 쓴다.
시작 체크
MCP 서버가 연결되어 있으면 작업 전에 mcp_server_health()를 호출해
version, pythonHwpxVersion, toolSurface.status, toolSurface.missingKeyTools를 확인한다.
toolSurface.status != "ok"이거나 핵심 도구가 누락되면 플러그인 재설치
(codex plugin remove hwpx-plugin@hwpx 후 codex plugin add hwpx-plugin@hwpx)
또는 stale plugin venv/cache 제거 후 새 호스트 세션을 시작하라고 안내한다.
단위는 인간 단위다: 글자 크기 pt, 줄간격 %, 들여쓰기 mm, 문단 간격 pt, 용지/여백 mm.
케이스 → 경로 라우팅 표
| 사용자 요청 패턴 | 1차 경로 (MCP 도구) | 상세 참조 |
|---|---|---|
| 낯선 기존 문서의 구조 탐색 + 본문·표 셀·기존 단순 머리글 story·블록 이종 편집·이동·복사 | get_document_node → query_document_nodes → apply_document_commands (dry-run → commit) |
workflows-agent-document |
| 지원 문서·결재/양식 블록을 다른 HWPX로 안전하게 이식 | get_document_node/query_document_nodes → dump_document_blueprint → replay_document_blueprint (dry-run → commit) |
workflows-agent-blueprint |
| 일반 복합 HWPX 읽기·편집·생성 (아래 전문 양식·시험 경로 제외) | start_workflow → continue_workflow → 필요 시 approve_workflow_decision |
workflows-autonomous |
| 최종 산출물을 실제 한컴으로 렌더·검증 | render_health → render_submit → render_status |
workflows-real-hancom-render |
| 양식 채움·기존 좌표 편집용 구조·표·필드·앵커 지도 | get_document_map |
workflows-editing |
| 텍스트·개요·표 내용 읽기 | get_document_text · get_document_outline · get_table_text |
api |
| Markdown/HTML/JSON 변환·추출 | hwpx_to_markdown · hwpx_to_html · hwpx_extract_json · document_to_markdown · document_extract_json |
api |
| 런서식(굵게·색·크기·글꼴) + 각주/미주 본문까지 충실 읽기 | hwpx_extract_json (format_detail·doc.notes[]) · hwpx_to_markdown (각주 부록) |
workflows-reading |
| 일반 텍스트 위치 찾기 | find_text |
workflows-editing |
| 이미 canonical path가 확정된 본문·표 좌표와 기존 단순 머리글 story 편집 (2건 이상) | apply_document_commands (dry-run → commit) |
workflows-agent-document |
| 바이트-스플라이스 다단 편집(표 구조+본문+셀 채움 혼합, 실패 시 부분 적용이 허용 안 되는 작업) | run_edit_plan (계획 1파일, dry_run=true → 실행 — all-or-nothing 원자, 개별 도구 연타 금지) |
workflows-editing |
| 단건 치환·문단·표 셀 편집 | search_and_replace · batch_replace · insert_paragraph · set_table_cell_text |
workflows-editing |
| 직전 편집 되돌리기 | undo_last_edit |
workflows-editing |
| 줄간격·정렬·들여쓰기·문단 간격 변경 | set_paragraph_format |
workflows-editing |
| 용지 크기·방향·여백·단 설정 | set_page_setup |
workflows-editing |
| 머리글/바닥글 추가·수정 | set_header_footer |
workflows-editing |
| 쪽번호 추가·수정 | set_page_number |
workflows-editing |
| 기존 문단을 불릿/번호 목록으로 | set_list_format |
workflows-editing |
| 그림 삽입 / 그림만 교체 | insert_picture · replace_picture |
workflows-editing |
| 굵게·색·글꼴 등 글자 서식, 사용자 스타일 | format_text · create_custom_style · list_styles |
workflows-editing |
| 표 병합·분할·머리행·테두리(선 종류/색/굵기)·셀 음영 | merge_table_cells · split_table_cell · format_table |
workflows-editing |
| 검토 메모 추가·삭제 | add_memo · add_memo_by_anchor · remove_memo |
workflows-editing |
| 충실도 민감·대형 문서의 문단 텍스트 패치 | byte_preserving_patch |
workflows-editing |
| 생성/편집 후 레이아웃 확인 | render_preview self-check 루프 |
workflows-editing |
| 한컴 없이 수식 포함 문서 스크롤 통독 검수 | render_preview(viewer=true, screenshot="off") |
workflows-preview |
| 자연어 요청으로 새 문서 생성 | validate_document_plan → create_document_from_plan |
workflows-creation |
| Markdown/비-HWPX 원본에서 HWPX 초안 생성 | document_to_markdown → markdown_to_document_plan → create_document_from_plan |
workflows-creation |
| 공문·보고서·가정통신문 (유형별 한컴 양식 프로파일 + 공문 구조 hard-gate·결문 메타·맞춤법 정직보고) | create_document_from_plan (metadata.document_type + gyeolmun) |
workflows-authoring |
| 살아있는 목차(한컴이 재계산)·쪽 번호 상호참조 | add_toc · add_cross_reference · verify_toc |
workflows-toc |
| 변경추적 redline 저작 (삽입/삭제/치환 + 코멘트, 사람이 한컴서 수락/거부) | add_tracked_edit (+ add_memo_by_anchor) |
workflows-redline |
| 개인정보(PII) 탐지·마스킹 (읽기·추출 기본 마스킹, 쓰기 입력 사전 정제) | scan_personal_info · 읽기/추출 mask param |
workflows-pii |
| 정부보고서·공문형 보고서 (□/○/※ 불릿) | parse_government_report_text → document plan 구성·검증 → create_document_from_plan |
workflows-creation |
| 운영 계획서 제출 후보 | document-plan + quality_profile="operating_plan" |
workflows-creation |
| 운영 계획서 하우스 스타일·섹션칩 변주 | skill이 genre/profile/variable slot 판단 → 기존 document-plan MCP 경로 | workflows-house-style |
| 제안서·기획안 | proposal document plan → create_document_from_plan → inspect_document_quality |
workflows-creation |
| 기안문 서식 저작 (별지 제1호 일반기안문 / 제2호 간이기안문) | compose_official_draft · compose_simple_draft → validate_document_plan → create_document_from_plan (결재란 칸은 결재자 수만큼만·결문 라벨 미인쇄·선택항목은 [ ]+√) |
workflows-authoring |
| 체크박스 양식개체가 실제로 쓰이는 서식(공문서 아님) | add_check_box 계열 core API (공문서는 [ ] 텍스트 관례) |
workflows-authoring |
| 공문서 작성규정 lint·결재란 | inspect_official_document_style |
workflows-creation, 규정 |
| 직인/관인 날인 (발신명의 끝글자에 도장) · 날인 규정 pass/fail 검사 | place_seal · check_seal_compliance |
workflows-forms |
| 출제 md를 학교 시험지 양식에 재조판 (문항 keep-together, 그림은 placeholder) | compose_exam · verify_question_splits |
workflows-exam |
LaTeX 수식을 네이티브 <hp:equation>으로 삽입 (커버리지 밖 typed 거부) |
add_equation |
workflows-authoring |
| 데이터 시리즈를 네이티브 차트로 삽입 (막대·꺾은선·원, 밖은 typed 거부) | add_chart |
workflows-authoring |
| 운영계획서를 백지에서 장르-충실하게 저작(섹션칩·개조식·박스 조직도) | get_genre_grammar · compose_section_chip · add_boxed_org_chart |
workflows-authoring |
| 평가계획(교수학습운영 및 평가계획) 전문 채움 (J1~J6 두뇌 판단·붙여넣기용 MD 저작) | apply_evalplan_fill(filename=..., review_md=..., output=..., phase="clean", render_check="required", score_gold_path=...) → 필요 시 advanced score_form_fill |
workflows-evalplan |
| 낯선 양식·누름틀·라벨 셀·경로 셀·표 밖 본문이 섞인 채움 | analyze_form_fill(plan=...) → plan 승인 → apply_form_fill(plan=...) (plan.dryRun dry-run → commit) → verify_form_fill(plan=...) |
workflows-forms |
| 메일머지 N부 대량생산 (상장·수료증·안내장·명부 CSV/XLSX) · 셀 넘침 격리(fit) | mail_merge (fit_mode) |
workflows-bulk-compare |
| 표 합계·평균·소계 계산 | table_compute |
workflows-bulk-compare |
| 두 문서/문단 비교 (신구 diff) | doc_diff |
workflows-bulk-compare |
| 신구대조표 문서 생성 | doc_diff → comparison document plan → create_document_from_plan |
workflows-bulk-compare |
| 사진대지 생성 | build_image_grid → create_document_from_plan |
workflows-bulk-compare |
| 회의 명패 생성 | build_meeting_nameplates → create_document_from_plan |
workflows-bulk-compare |
| 조직도 생성 | build_organization_chart → create_document_from_plan |
workflows-bulk-compare |
| 참조 문서 서식 이식·템플릿 등록 | extract_style_profile · apply_style_profile_to_plan · register_template |
workflows-bulk-compare |
| 붙임·표/그림 번호 정합성 검사 | inspect_reference_consistency |
workflows-bulk-compare |
| 깨졌거나 한컴에서 안 열리는 파일 | repair_hwpx (복구 복사본 생성) |
api |
| 원본 보존용 사본 만들기 | copy_document |
api |
| MCP 없음: 텍스트 추출·표 포함 전역 치환 | scripts/text_extract.py · scripts/zip_replace_all.py |
api |
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- CHANGELOG.md 40 KB
- examples/01_create_and_save.py 1.1 KB runs code
- examples/02_extract_and_inspect.py 1.2 KB runs code
- examples/03_template_replace.py 2.0 KB runs code
- examples/04_create_proposal.py 2.5 KB runs code
- examples/05_mcp_quality_pipeline.md 2.1 KB
- examples/06_create_from_document_plan.py 3.6 KB runs code
- examples/06_mcp_document_plan.md 2.9 KB
- examples/07_create_operating_plan.py 7.2 KB runs code
- examples/07_mcp_operating_plan.md 2.7 KB
- examples/08_mcp_canonical_form_fill.md 3.6 KB
- examples/08_template_formfit.py 4.1 KB runs code
- examples/09_visual_review_loop.md 4.3 KB
- examples/10_create_government_report.py 5.8 KB runs code
- examples/10_create_with_builder.py 4.4 KB runs code
- examples/10_mcp_government_report.md 3.8 KB
- examples/11_computeruse_visual_review.md 4.2 KB
- examples/11_official_document_recipes.py 5.8 KB runs code
- examples/12_task_eval_replay.md 2.9 KB
- examples/13_advanced_generators.py 3.9 KB runs code
- examples/14_mail_merge_table_compute.py 4.7 KB runs code
- examples/eval_tasks/profiles/baseline-0.1.5.json 820 B
- examples/eval_tasks/profiles/current-0.1.6.json 354 B
- examples/eval_tasks/profiles/current-0.1.8.json 523 B
- examples/eval_tasks/profiles/current-0.3.0.json 639 B
- examples/eval_tasks/profiles/current-0.8.0.json 641 B
- examples/eval_tasks/profiles/current-1.0.0.json 651 B
- examples/eval_tasks/profiles/current-1.1.0.json 651 B
- examples/eval_tasks/tasks.json 28 KB
- packaging/old-name-taxonomy.json 3.5 KB
- packaging/product-identity.json 3.7 KB
- README.md 8.0 KB
- references/api.md 37 KB
- references/evidence-contract.md 6.1 KB
- references/government-report-visual-review.md 3.0 KB
- references/migration-core-5.0.md 3.6 KB
- references/migration-mcp-5.0.md 2.6 KB
- references/official-document-rules.md 2.0 KB
- references/tool-contract.generated.json 655 KB
- references/tool-contract.generated.md 16 KB
- references/workflows-agent-blueprint.md 6.4 KB
- references/workflows-agent-document.md 7.1 KB
- references/workflows-authoring.md 9.0 KB
- references/workflows-autonomous.md 4.6 KB
- references/workflows-bulk-compare.md 8.4 KB
- references/workflows-creation.md 11 KB
- references/workflows-editing.md 15 KB
- references/workflows-evalplan.md 9.2 KB
- references/workflows-exam.md 7.1 KB
- references/workflows-forms.md 11 KB
- references/workflows-house-style.md 2.7 KB
- references/workflows-pii.md 2.8 KB
- references/workflows-preview.md 5.7 KB
- references/workflows-reading.md 3.0 KB
- references/workflows-real-hancom-render.md 3.0 KB
- references/workflows-redline.md 3.2 KB
- references/workflows-toc.md 2.9 KB
- scripts/detect_hwpx_viewer.py 5.0 KB runs code
- scripts/fix_namespaces.py 8.9 KB runs code
- scripts/quickcheck.py 17 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 205 lines · 173 tokens per session scan A bdc506bd2276
hwpx is a skill published in the GitHub repository airmang/hwpx-plugins (25 stars, last pushed 11d ago), licensed Apache-2.0. It adds 173 tokens to every session and 6,567 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to hwpx, differing in 0 lines, and is treated as a copy.
Other skills, from other repositories
form-fill
Use this workflow when filling an existing HWPX across native fields, labeled cells, canonical paths, and body anchors through one analyzed, atomic, and verified mixed-form transaction.
reference-preserving-edit
Use this workflow when editing an existing HWPX while minimizing layout drift by copying first, inspecting the relevant package parts, making bounded edits with the current MCP tools, and validating the result before handoff.
template-generation
Use this workflow when generating an HWPX from an approved template or from a new blank document by orchestrating the current MCP text, table, style, and copy tools without adding new public server tools.
kordoc
Use this skill whenever the user wants to read, create, fill, edit, compare, validate, or preview Korean Hangul/official documents — .hwp (HWP 3.x/5.x), .hwpx, .hml (HWPML) — or convert Korean-office PDF/DOCX/XLS/XLSX to Markdown. Triggers include any mention of 'hwp', 'hwpx', 'hml', '한글 문서', '아래한글', '한컴', '공문서'…
ai-hwp-reader
한글 문서(.hwp·.hwpx)나 그 문서가 든 .zip을 읽어야 할 때 쓴다. 한컴 없이 본문·표(병합 셀, 2·3단 헤더, 표 안의 표)·숨은 메모·변경추적·각주·수식·링크·이미지 참조를 보존해 마크다운으로 뽑는다. "hwp 읽어줘"·"아래아한글 문서 요약"·hwpx 파싱·한글 첨부문서 검토·표 추출 요청에서 발동한다. PDF·docx·xlsx에는 쓰지 않는다.
ai-hwp-reader
이 파일은 사람이 읽는 설명서가 아니라 AI 실행 스킬이다. 사용자가 이 SKILL.md와 .hwp / .hwpx / .zip 파일을 함께 첨부하면 아래 지시를 우선해 실제 문서를 파싱하고, 그 결과를 근거로 사용자가 요청한 일을 끝내라.