- Home
- Skills
- Workflow Automation
- hwpctl — Fill, Edit & Design Hancom Hangul (한글) Documents
More screenshots
Works with the AI Agents you already use
hwpctl — Fill, Edit & Design Hancom Hangul (한글) Documents
Let your local AI agent fill Korean forms, fix tables, and build editable HWP/HWPX pages inside real Hancom Hangul: layout intact, page checked, saved as a new file. 한/글 양식·보고서·안내문을 표 모양 그대로 채우고 고칩니다.
$5
hwpctl — Fill, Edit & Design Hancom Hangul (한글) Documents
Example session with this skill installed
참가신청서_양식.hwpx에 아래 정보를 채워 줘. 표 모양은 바꾸지 말고, 고른 항목에만 ■ 표시해 줘. 다 채우면 화면을 확인하고 새 파일로 저장한 뒤 비어 있는 칸을 알려 줘.
- 이름 김하늘 / 생년월일 1994. 05. 17. / 연락처 010-1234-5678 / 이메일 haneul@example.com
- 소속 가람출판 편집팀, 편집자(교재 편집) / 주소 서울특별시 중구 예시로 12, 3층
- 실무반, 대면 참여 / 사전 경험: 한/글 표·양식 편집, AI 챗봇 업무 활용
- 신청 동기: 매달 교육 신청서와 결과보고서를 한/글로 작성하는데, 표 칸을 맞추고 서식을 정리하는 데 시간이 많이 듭니다. AI 에이전트로 양식을 정확히 채우고 결과를 확인하는 방법을 배워 팀 업무에 적용하고 싶습니다.
- 개인정보 수집 동의, 신청일 2026년 10월 26일
- Read your context and instructions
- Compiled the hwpctl
Filled a Korean application form: 14 fields, layout unchanged, photo left blank (not supplied), saved as a new file.
참가신청서 작성 완료
| 항목 | 칸 | 기입 내용 |
|---|---|---|
| 성명 · 생년월일 | B1 · D1 | 김하늘 · 1994. 05. 17. |
| 연락처 · 이메일 | B2 · D2 | 010-1234-5678 · haneul@example.com |
| 소속 · 직위·직무 | B3 · D3 | 가람출판 편집팀 · 편집자 · 교재 편집 |
| 주소 | B4 | 서울특별시 중구 예시로 12, 3층 |
| 신청 과정 | B5 | ■ 실무반 (기초반·심화반 □ 유지) |
| 참여 방식 | B6 | ■ 대면 |
| 사전 경험 | B7 | ■ 한/글 표·양식 편집 ■ AI 챗봇 업무 활용 |
| 신청 동기 | B8 | 제공한 문장 그대로 |
| 개인정보 수집 동의 | B9 | ■ 동의함 |
| 신청일 · 신청인 | B11 · B12 | 2026년 10월 26일 · 김하늘 |
비워 둔 칸: 사진(파일을 받지 못함), 서명(직접 서명 필요)
확인한 것
- 쓰기 전에 양식 구조를 읽고 셀 30개의 주소를 확인했습니다. 병합 셀은 왼쪽 위 주소를 썼습니다.
- 1쪽 그대로이고, 열 너비와 병합도 바뀌지 않았습니다. 렌더링한 화면을 직접 확인했습니다.
- 이메일은 한/글이 하이퍼링크로 바꾸지 않도록 마지막에 따로 입력했습니다.
- 참가신청서_김하늘.hwpx로 새로 저장하고 다시 열어 화면이 같은지 확인했습니다. 원본 양식은 그대로입니다.
참고: 표 행 높이를 줄이자는 자동 제안은 양식 모양을 바꾸므로 적용하지 않았습니다.
Live run 2026-10-26 · Hancom Hangul 2022 (12.0.0.4605) · hwpctl 0.2.1 · fictional form and applicant. The gallery shows the actual renders.
Connects securely to your tools. The creator never sees your data.
About this skill
Why generic AI struggles with HWP, and what this skill does instead
Ask a chatbot to edit an .hwp or .hwpx file and you often get a Python script that cannot read the format, or a document whose borders, merged cells, and fonts no longer line up. Korean forms are fixed grids of labels, merged cells, and checkboxes, and they break easily.
This skill puts your local AI agent inside real Hancom Hangul through hwpctl, the open-source MCP/CLI bridge. The agent reads the form first, maps every label to its cell, writes only what you gave it, ticks only the boxes you chose, renders the page to check it, and saves a new file. You get an editable Hangul document and a short report: what changed, what was checked, and what is still blank.
What you can do
- Fill forms: résumés, career statements, and application forms (이력서·경력기술서·신청서). Your details go into the right cells, ■ marks only the options you chose, and fields left blank are listed.
- Revise tables and formatting: change a schedule, a person in charge, or one paragraph's style, then check wrapping and page flow around it.
- Draft reports: turn notes into headings, a summary, body text, and real editable tables, following your institution's template when you have one.
- Design notices and worksheets: readable one-page layouts with tables and answer spaces, or posters with gradient 글맵시 headlines and native shapes.
Verified on a real form
In Hangul 2022 the agent filled a 12-row application form with 14 supplied values in 16 tool calls. It left the photo cell blank because no photo was supplied, kept the grid and the one-page fit, saved a new file, and reopened it with an identical render. The gallery shows the actual Hangul renders. The same run found a Hangul quirk, e-mail addresses turning into hyperlinks mid-fill, and the skill now writes such values in a way that avoids it.
How every task runs
Confirm the document → map and edit only what is needed → check the content and the rendered page → save a new file → report
The source is not overwritten by default. If a step fails, the agent stops instead of retrying blindly, and the report separates what was checked from what still needs your eyes.
What's inside
- SKILL.md workflow: target confirmation, tool choice, verification, and recovery
- Form-filling rules: field maps, checkboxes, long answers, e-mail/URL values, and the cell's own style
- Verified examples: an application-form fill, a notice edit, and an editable poster sequence
- Korean layout starters for reports, notices, and worksheets
- Four copy-ready prompts in Korean and English
- Setup guide for the hwpctl 0.2.1 release and a read-only environment checker
- Recovery steps for dialogs, locks, partial edits, and timeouts
Supported environment and safe boundaries
Built for Windows with licensed Hancom Hangul 2022 (tested on build 12.0.0.4605), Python 3.10+, and the free hwpctl 0.2.1 bridge, used by an agent that can start a local MCP server or CLI, such as Claude Code, Codex, Cursor, or Gemini CLI (setup examples included). Adding the skill installs nothing by itself; the guide walks you through setup.
Hangul is driven locally and files are opened and saved on your PC. The AI service you connect can read the document content you work on, under its own data policy. The bridge is in Alpha, so the skill always saves to new files and reports partial changes instead of hiding them. It is not a PDF/DOCX converter or OCR tool. Independent project, not a Hancom product.
한국어 안내
한/글 양식, 표 모양 그대로 채우고 고치세요
일반 챗봇에게 HWP 파일을 맡기면 파일을 읽지 못하는 코드를 짜거나, 표 테두리와 칸 정렬이 틀어진 문서가 돌아오기 쉽습니다. 이 스킬은 로컬 AI 에이전트가 실제 한/글을 직접 다루게 합니다. 양식 구조를 먼저 읽고, 항목과 칸을 대응시키고, 제공한 정보만 채우고, 고른 항목만 ■로 표시한 뒤, 화면을 렌더링해 확인하고 새 파일로 저장합니다.
- 양식 채우기: 이력서·경력기술서·신청서. 비워 둔 칸은 목록으로 알려 줍니다.
- 표·서식 수정: 일정·담당자·문단 서식 등 필요한 곳만 바꾸고 줄바꿈과 쪽 나눔을 확인합니다.
- 보고서 초안: 메모를 제목·요약·본문·편집 가능한 표로 구성합니다. 기관 양식이 있으면 그 양식을 따릅니다.
- 안내문·학습지·포스터: 표와 답안 공간, 글맵시 제목과 도형으로 한 장짜리 문서를 만듭니다.
12행짜리 신청서에서 14칸을 16번의 도구 호출로 채웠고, 사진은 파일이 없어 비워 둔 채 보고했습니다. 새 파일을 다시 열어 화면이 같은 것까지 확인했습니다. 갤러리 이미지는 실제 한/글 렌더링입니다.
필요한 것: Windows, 정품 한/글 2022, Python 3.10+, 무료 오픈소스 hwpctl 0.2.1(설치 가이드 포함). 원본은 기본적으로 덮어쓰지 않고, 실패한 단계는 반복하지 않고 멈춘 뒤 보고합니다. PDF/DOCX 변환기와 OCR은 포함하지 않으며, 한컴과 제휴하지 않은 독립 프로젝트입니다.
Built and tested for Hangul 2022 (build 12.0.0.4605) on Windows; other builds may differ. hwpctl is Alpha and has no autosave, so the skill saves to new files and reports any partial change. Irregular merges, nested tables, and mixed formatting inside one cell are checked case by case. Not a PDF/DOCX converter or OCR tool. The connected AI service can read the document content you work on.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 22 days ago
Requires
Permissions
Terminal runs the local hwpctl MCP/CLI and optional static Python environment checker. The checker reads runtime package metadata, launcher availability and Hancom COM registration without starting COM, opening documents or using the network. File access opens user-designated HWP/HWPX files and saves fresh outputs. Network is only needed for a separately authorized bridge installation from GitHub. No automatic installation or uploads; no binaries are bundled. Connected AI providers may process document content according to their own settings.