hwpx

Automates creation, editing, parsing of HWPX documents via XML workflows.

54|10|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/ai-public-peasant/hwpx-rekian --skill hwpx-ai-public-peasant
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: hwpx
Source: https://github.com/ai-public-peasant/hwpx-rekian/tree/main/hwpx
Command: npx skills add https://github.com/ai-public-peasant/hwpx-rekian --skill hwpx-ai-public-peasant

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires lxml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

HWPX ๋ฌธ์„œ๋ฅผ XML-first ์›Œํฌํ”Œ๋กœ์šฐ๋กœ ์ƒ์„ฑ, ์ฝ๊ธฐ, ํŽธ์ง‘ํ•˜๋Š” ์ž๋™ํ™” ์Šคํ‚ฌ๋กœ, ํ•œ์ปด ์˜คํ”ผ์Šค ์„ค์น˜ ์—†์ด HWPX ๊ตฌ์กฐ๋ฅผ ํ”„๋กœ๊ทธ๋ž˜๋ฐ์œผ๋กœ ๋‹ค๋ฃฐ ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ค๋‹ˆ๋‹ค.

Core Features & Use Cases

  • XML-first ๋ฐฉ์‹์œผ๋กœ HWPX ํ…œํ”Œ๋ฆฟ ๊ธฐ๋ฐ˜์˜ ๋ฌธ์„œ ์ƒ์„ฑ์„ ์ง€์›ํ•˜๊ณ , section0.xml๊ณผ header.xml๋ฅผ ์ง์ ‘ ํŽธ์ง‘ํ•ด ์ •๊ตํ•œ ๋ ˆ์ด์•„์›ƒ์„ ๊ตฌํ˜„ํ•ฉ๋‹ˆ๋‹ค.
  • unpack/pack ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ํ†ตํ•ด ๊ธฐ์กด ๋ฌธ์„œ๋ฅผ XML๋กœ ๋ณ€ํ™˜ํ•˜๊ณ  ์žฌํŒจํ‚ค์ง•ํ•˜๋Š” ํŽธ์ง‘ ํŒŒ์ดํ”„๋ผ์ธ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ํ…์ŠคํŠธ ์ถ”์ถœ, ํ‘œ ์ž‘์„ฑ, ๋ฉ”๋ชจ/์ฃผ์„ ํฌํ•จ ๋“ฑ ๋ฌธ์„œ ์ž‘์—…์˜ ์ผ๋ฐ˜ ์›Œํฌํ”Œ๋กœ์šฐ์— ์ ์šฉ ๊ฐ€๋Šฅํ•˜๋ฉฐ, ๋ ˆํผ๋Ÿฐ์Šค ๊ธฐ๋ฐ˜ ์žฌ์ž‘์„ฑ์„ ๋•์Šต๋‹ˆ๋‹ค.
  • ํ…œํ”Œ๋ฆฟ(gonmun, report, minutes, ๊ธฐ๋ณธ) ์˜ค๋ฒ„๋ ˆ์ด๋ฅผ ์ด์šฉํ•ด ์‹ ์†ํ•˜๊ฒŒ ํ˜•์‹์„ ์„ ํƒํ•˜๊ณ  ๋ฌธ์„œ๋ฅผ ๊ตฌ์„ฑํ•ฉ๋‹ˆ๋‹ค.

Quick Start

Create a basic HWPX document skeleton with the hwpx skill and then edit Contents/section0.xml.

Frequently Asked Questions about hwpx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate HWPX documents without installing Hancom Office?โ–ผ

You can generate HWPX documents without Hancom Office by using an XML-first automation workflow. It assembles valid HWPX packages directly through Python scripts and lxml, overriding section0.xml and header.xml for precise layout control.

Can I edit an existing HWPX file by unpacking and modifying the XML?โ–ผ

Yes, you can edit an existing HWPX file by unpacking it into XML components. The unpack/pack workflow converts the document into editable XML, allowing you to modify the structure before repackaging it back into a valid HWPX format.

What Python dependencies are required to automate HWPX document creation?โ–ผ

To automate HWPX document creation, you need a Python environment with the lxml library installed. This dependency enables the XML parsing and manipulation required to assemble and validate the HWPX packages.

Does the HWPX workflow support templates for reports and minutes?โ–ผ

Yes, the HWPX workflow supports template-based document generation for reports, minutes, and Gonmun-style documents. You can select a template overlay to quickly establish the format and structure for your automated document creation.

What is the best way to validate an HWPX package after editing the XML?โ–ผ

The best way to validate an HWPX package after editing is to use the included validate.py script. It checks the assembled XML structure and package integrity to ensure the final HWPX document is valid and correctly formatted.

Are there limitations to editing section0.xml directly in an HWPX package?โ–ผ

Directly editing section0.xml requires understanding the HWPX XML schema to avoid structural errors. You must repack and validate the package using the provided scripts to ensure the edits do not corrupt the document layout or content.