mcpField
W
word-power-tools

word-power-tools

github.com/chi111iDocuments1138 installsUpdated 40w ago
Repository

About word-power-tools

word-power-tools is a Claude Code skill for processing Word documents through a dedicated script. It supports extraction, conversion, formatting checks, and editing, with an emphasis on reproducible operations that preserve the original file by default.

Key features

  1. 01Inspect document details and outlines
  2. 02Extract text, tables, and images
  3. 03Convert between document formats
  4. 04Apply batch replacements and metadata
  5. 05Check and standardize formatting
  6. 06Merge, split, and create documents

Use cases

  1. 01Convert DOCX to PDF or Markdown
  2. 02Extract Word tables and images
  3. 03Check thesis formatting and create a report
  4. 04Split documents by heading or merge files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/chi111i/word-power-tools --skill word-power-tools

After installing, type/word-power-toolsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
.gitignore
requirements.txt
docs/
FORMAT_RULES.md
SECURITY.md
TROUBLESHOOTING.md
INSTALL.md
USAGE.md
installers/
uninstall.ps1
install.ps1
install.sh
uninstall.sh
scripts/
selftest.py
word_tool.py
scripts/wordlib/
common.py
convert.py
__init__.py
extract.py
edit.py
metadata.py
toc.py
validate.py
templates/
replace_rules.example.yaml
metadata.example.yaml
format_thesis_qfnu_science.yaml
format_thesis_qfnu_arts.yaml
thesis_skeleton.example.yaml

Details

From the project README

Word Power Tools

本 Skill 的目标：让 Claude Code 在本地（Linux/macOS/Windows）把 Word 文档当作可编程文档来可靠处理。

⚠️ 核心原则

必须优先使用本 Skill 提供的脚本 scripts/word_tool.py，最好不要自己编写临时脚本或一次性代码。

所有文档操作都应通过 word_tool.py 的子命令完成，确保可复现性和稳定性。

适用场景（触发关键词）

  • “把 docx/doc 转 pdf/markdown/html/txt”
  • “从 Word 提取表格/图片/章节结构/正文文本”
  • “论文排版、格式统一、目录、页码、页眉页脚”
  • “批量替换、合并、拆分、套模板”
  • “格式审查（页边距、字体、行距、标题层级）并输出报告”

原则（减少风险 + 提高可复现性）

  1. 默认不覆盖原文件：所有会改写的操作必须写到新输出文件（-o/--output）。
  2. 先 lint 后 format：排版类任务先生成报告，再应用修复（避免"修坏了但不知道改了什么"）。
  3. 复杂任务用脚本输出：脚本可"零上下文执行"，输出更稳定、可测试。

Quickstart

依赖自检（推荐每个新环境先跑一次）：

python scripts/word_tool.py doctor

文档概览：

python scripts/word_tool.py info path/to/file.docx
python scripts/word_tool.py outline path/to/file.docx

提取：

python scripts/word_tool.py extract-text path/to/file.docx -o out.txt
python scripts/word_tool.py extract-tables path/to/file.docx -o tables/ --format xlsx
python scripts/word_tool.py extract-images path/to/file.docx -o images/

转换：

python scripts/word_tool.py convert input.doc  --to docx -o output.docx
python scripts/word_tool.py convert input.docx --to pdf  -o output.pdf
python scripts/word_tool.py convert input.docx --to md   -o output.md

批量替换（YAML 规则）：

python scripts/word_tool.py replace input.docx --rules templates/replace_rules.example.yaml -o replaced.docx

写入元数据（作者/标题等）：

python scripts/word_tool.py set-metadata input.docx --metadata templates/metadata.example.yaml -o meta.docx

插入目录（TOC 字段，需要在 Word 里“更新域”才能渲染）：

python scripts/word_tool.py toc input.docx --levels 1-3 -o with_toc.docx

排版校验 + 应用统一格式（YAML 配置）：

python scripts/word_tool.py lint   input.docx --config templates/format_thesis_qfnu_science.yaml -o report.md
python scripts/word_tool.py format input.docx --config templates/format_thesis_qfnu_science.yaml -o fixed.docx

合并/拆分：

python scripts/word_tool.py merge a.docx b.docx c.docx -o merged.docx
python scripts/word_tool.py split input.docx --by heading1 -o split_out/

生成新文档骨架（论文/报告模板化）：

python scripts/word_tool.py new --template templates/thesis_skeleton.example.yaml -o thesis.docx

参考文档（按需读取）

  • 安装与环境：docs/INSTALL.md
  • 使用手册（所有子命令）：docs/USAGE.md
  • 排版规则配置：docs/FORMAT_RULES.md
  • 常见问题：docs/TROUBLESHOOTING.md
  • 安全注意事项：docs/SECURITY.md

Comments

Markdown supported