hwpx

Generate, edit, and extract content from HWPX documents via XML manipulation with Python scripts.

22|7|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/berrzebb/SoulFlow-Orchestrator --skill hwpx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hwpx
Source: https://github.com/berrzebb/SoulFlow-Orchestrator/tree/main/src/skills/hwpx
Command: npx skills add https://github.com/berrzebb/SoulFlow-Orchestrator --skill hwpx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lxml, and includes scripts (resource) and references (resource) and templates (resource) components.

What problem does it solve?

This Skill allows for the programmatic creation, editing, and extraction of text from HWPX (Hancom Office) documents, bypassing the limitations of direct API manipulation by working with the underlying XML structure.

Core Features & Use Cases

  • XML-First Document Generation: Create HWPX files from scratch or templates by directly manipulating XML.
  • Template-Based Creation: Utilize pre-defined templates (e.g., for official documents, reports) and customize them.
  • Data Extraction: Extract plain text or Markdown-formatted content from existing HWPX files.
  • Use Case: Generate a standardized company report in HWPX format, automatically populating sections with data fetched from a database.

Quick Start

Use the hwpx skill to create a new HWPX document using the 'report' template.

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 programmatically using XML manipulation?

You can generate HWPX documents programmatically by directly manipulating the underlying OWPML XML structure with Python scripts. This XML-first approach bypasses direct API limitations, allowing you to build files from scratch or apply template overlays for automated document generation.

Can I extract plain text or Markdown from existing HWPX files?

Yes, you can extract plain text or Markdown-formatted content from existing HWPX files. The Skill parses the internal OWPML XML structure to retrieve text, making it straightforward to pull data for downstream processing or migration.

How do I automate HWPX document creation from pre-defined templates?

You can automate HWPX document creation by applying pre-defined templates and customizing them through XML overrides for headers and sections. This allows you to populate standardized reports or official documents dynamically with data.

Does HWPX document generation work with Python and lxml?

Yes, HWPX document generation works with Python and requires the lxml dependency for XML manipulation. This allows you to perform custom XML overrides for headers and sections while maintaining document integrity through validation and page drift checks.

What is the best way to edit HWPX files without relying on direct API manipulation?

The best way to edit HWPX files without direct API manipulation is using an XML-first approach to modify the OWPML structure directly. This method enables precise content updates, metadata modifications, and custom section overrides while validating document integrity.

How do I validate HWPX document integrity and check for page drift?

You can validate HWPX document integrity and check for page drift by using the built-in validation features of the XML-first generation process. This ensures that custom XML overrides and template overlays do not corrupt the document structure or cause layout issues.