⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

HWP/HWPX 韩语文档阅读器技能 - 支持 .hwp .hwpx 文件内容提取与转换

hwp by pitzcarraldo/skills

70 周安装量

GitHub

安装命令

npx skills add https://github.com/pitzcarraldo/skills --skill hwp

办公软件文件管理命令行工具

🇨🇳中文介绍

HWP/HWPX 文档阅读器

此技能读取韩语 Hangul Word Processor 文件（.hwp, .hwpx），并使用 pyhwp2md 基于内容准备响应。

支持的格式

格式	扩展名	描述
HWP	`.hwp`	二进制格式 (HWP 5.0+)
HWPX	`.hwpx`	基于 XML 的格式 (Hangul 2014+)

工作流程

重要 : 切勿直接运行 uvx、pipx 或 pip 命令。请始终使用下面完整的 bash 脚本，它会自动检测并使用正确的工具。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 验证文件存在

ls -la "[file-path]"

2. 检测并提取内容

运行此精确脚本（请勿修改或单独运行命令）：

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. 根据大小处理输出

如果内容适合上下文 : 直接使用 stdout 输出来响应用户查询。

如果内容过大，超出上下文限制 : 使用此脚本保存到临时文件：

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

然后根据需要分块读取文件以回答用户问题。

要求	版本	备注
Python	3.10+	必需
uv/pipx/pip	最新	其中任意一个

图像 : 暂不支持
链接 : 部分支持
格式 : 样式、颜色和字体不保留

2026 年 1 月 21 日

🇺🇸English

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

References

Weekly Installs

Repository

pitzcarraldo/skills

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykPass

Installed on

codex60

gemini-cli59

opencode59

github-copilot55

amp49

kimi-cli48

飞书OpenAPI Explorer：探索和调用未封装的飞书原生API接口

40,800 周安装