HWPX Document Processing Skill

Hermes Agent skill for inspecting, generating, editing, validating, and repackaging Hancom HWPX documents using a safe ZIP/XML OWPML workflow.

What this contains

• SKILL.md — main Hermes skill instructions.
• scripts/ — helper scripts for validation, extraction, seed-based creation, placeholder filling, equation/table/image insertion, and existing-object replacement.
• references/ — workflow and helper-script reference docs.

Core principles

• HWPX-only ZIP/XML workflow; binary .hwp is read-only/fallback territory.
• Clone-and-mutate from known-good seed/template files.
• Preserve styles, geometry, object references, and package metadata when possible.
• Use real hp:equation objects for substantive formulas.
• Treat rhwp rendering as weak smoke check only; final visual authority is Hancom Office/PDF.
• For generated documents, verify requested format coverage, content density, equation fidelity, and whitespace/readability before returning.

Install locally

Copy this directory into your Hermes skills directory:

mkdir -p ~/.hermes/skills/productivity
cp -a . ~/.hermes/skills/productivity/hwpx-document-processing

Then start a fresh Hermes session and load hwpx-document-processing.

Quick validation

python scripts/validate_hwpx.py your-file.hwpx
python scripts/extract_hwpx_text.py your-file.hwpx --format json -o extract.json