hwpx-gov-doc

Generate validated HWPX government documents from structured JSON input.

2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/cdsassj00/hwpx-generator --skill hwpx-gov-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hwpx-gov-doc
Source: https://github.com/cdsassj00/hwpx-generator/tree/main/skill-python
Command: npx skills add https://github.com/cdsassj00/hwpx-generator --skill hwpx-gov-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates creation of Hancom HWPX format government documents from structured inputs so users and AI systems receive validated, non-corrupted .hwpx files ready for distribution.

Core Features & Use Cases

  • Zero-dependency Python generator that assembles HWPX ZIP archives from embedded base64 templates (header.xml, content.hpf, etc.).
  • Enforces AI-friendly document rules: complete sentences with explicit subjects, standard numbering (Ⅰ. → 1. → 가.), no merged cells, and minimal styling to avoid parsing errors.
  • Produces 서면보고 (official reports) and 보도자료 (press releases) including title blocks, metadata, tables, contacts, attachments, and can return either a saved file path or raw bytes for Timely/Claude platforms.

Quick Start

Call the create_gov_hwpx(doc) function in skill-python/scripts with a JSON-like document dict to generate and save a validated .hwpx file or call create_gov_hwpx_bytes(doc) to receive raw bytes.

Frequently Asked Questions about hwpx-gov-doc

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

FAQPage Schema
How do I generate HWPX government documents from JSON input using Python?

To generate HWPX government documents from JSON input, call the create_gov_hwpx function with a structured document dict to produce a validated .hwpx file. It assembles HWPX ZIP archives from base64 templates without external libraries.

Can I create Hancom HWPX files in Python without installing any dependencies?

Yes, you can create Hancom HWPX files with zero dependencies. This Python generator embeds required XML templates like header.xml and content.hpf as base64 strings, assembling the final ZIP archive natively without needing Hancom libraries.

What is the best way to automate writing Korean government reports like 서면보고 and 보도자료?

Automating Korean government reports like 서면보고 and 보도자료 is best handled by structuring your content as JSON with title, metadata, sections, and tables. The generator enforces AI-friendly rules like standard numbering and no merged cells to prevent parsing errors.

How do I get raw HWPX bytes instead of a saved file path for platform integration?

To get raw HWPX bytes instead of a saved file path, use the create_gov_hwpx_bytes function with your document dict. This returns raw bytes suitable for direct integration into Timely or Claude platforms without writing to disk.

Why do my generated HWPX files get corrupted or fail to open in Hancom?

Generated HWPX files get corrupted when formatting rules are violated, such as using merged cells or incomplete sentences. This generator prevents corruption by enforcing minimal styling, standard numbering, and valid XML structure for Hancom compatibility.

Does this HWPX generator support adding attachments and contact sections to official reports?

Yes, this HWPX generator supports adding attachments and contact sections to official reports. You define these elements within your structured JSON input, and the tool renders them directly into the Hancom-compatible HWPX template.