HWP/HWPX Document Reader

This skill reads Korean Hangul Word Processor files (.hwp, .hwpx) and prepares to respond based on the content using pyhwp2md.

Supported Formats

Format	Extension	Description
HWP	`.hwp`	Binary format (HWP 5.0+)
HWPX	`.hwpx`	XML-based format (Hangul 2014+)

Workflow

CRITICAL: NEVER run uvx, pipx, or pip commands directly. ALWAYS use the complete bash script below which automatically detects and uses the correct tool.

1. Verify File Exists

ls -la "[file-path]"

2. Detect and Extract Content

Run this EXACT script (do not modify or run individual commands):

TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" ;; pipx) pipx run pyhwp2md "[file-path]" ;; pip) pip install -q pyhwp2md && pyhwp2md "[file-path]" ;; *) echo "Error: No Python package runner found" ;; esac

3. Handle Output Based on Size

If content fits in context: Use the stdout output directly to respond to user queries.

If content is too large for context: Save to a temporary file using this script:

TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pipx) pipx run pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pip) pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; esac

Then read the file in chunks as needed to answer user questions.

Technical Requirements

Requirement	Version	Note
Python	3.10+	Required
uv/pipx/pip	Latest	Any one of these

Limitations

Images: Not yet supported
Links: Partial support
Formatting: Styles, colors, and fonts are not preserved

hwp