This skill reads Korean Hangul Word Processor files (.hwp, .hwpx) and prepares to respond based on the content using pyhwp2md.
Supported Formats
| 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
| 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