Agent skill

Read DOCX Review

by daymade in daymade/claude-code-skills

读取 Word/WPS 审阅后的 docx,把批注(comments)与修订(track changes)提取成可逐条裁决的 markdown 对账表或 JSON。触发场景:对方批注完的合同/协议/书稿/报告回来了要读意见;「提取 docx 批注」「审阅意见对账」「读一下修订」「谁批了什么、批在哪」;WPS 云文档/Word 在线协作…

MITAuto-check passedDocuments & Office

Install Read DOCX Review

skills CLI
$ npx skills add daymade/claude-code-skills --skill read-docx-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install daymade/claude-code-skills read-docx-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/daymade/claude-code-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/daymade-docs/read-docx-review .claude/skills/read-docx-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
read-docx-review
GitHub stars
1.4k
Token cost
~993 tokens
SKILL.md length
206 words
Files
8 (incl. scripts, references)
Skills in repo
104
Repo updated
First seen
Licence
MIT

At a glance

读取 Word/WPS 审阅后的 docx,把批注(comments)与修订(track changes)提取成可逐条裁决的 markdown 对账表或 JSON。触发场景:对方批注完的合同/协议/书稿/报告回来了要读意见;「提取 docx 批注」「审阅意见对账」「读一下修订」「谁批了什么、批在哪」;WPS 云文档/Word 在线协作…

  • Tasks that involve Word documents
  • SKILL.md covers 快速开始, 为什么必须走这套引擎(不要退回 python-docx 裸读), 依赖(首次使用装一次) and Troubleshooting, plus 2 more sections
  • Runs Python scripts from its folder; calls uv, brew and dotnet

What it does

Read DOCX Review is an agent skill from daymade/claude-code-skills. 读取 Word/WPS 审阅后的 docx,把批注(comments)与修订(track changes)提取成可逐条裁决的 markdown 对账表或 JSON。触发场景:对方批注完的合同/协议/书稿/报告回来了要读意见;「提取 docx 批注」「审阅意见对账」「读一下修订」「谁批了什么、批在哪」;WPS 云文档/Word 在线协作 导出的审阅稿;收到带修订模式改动的回稿要看对方改了什么。核心保证:修订感知——python-docx 裸读会漏掉修订插入(w:ins)的内容、认不出整段删除(w:del),本 skill 走 OpenXML SDK 引擎 不漏。只读,不改对方文件。边界:生成/排版 docx → docx-creator 或 minimax-docx;PDF 批注不在范围。

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `references/csharp-tasks-spec.md`, `scripts/bridge_lib/__init__.py` and `scripts/bridge_lib/docx_bridge_client.py`).

It sits in Documents & Office, covering Word documents. It works with Microsoft Word, python-docx, MiniMax and Python. The repository describes itself as: Professional Claude Code skills marketplace featuring production-ready skills for enhanced development workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve Word documents

Example prompts

  • “/read-docx-review”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 0e52df5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 6 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • brew
    • dotnet

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Read DOCX Review loads about 993 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 91 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~993
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from daymade/claude-code-skills at commit 0e52df5, republished under its MIT licence (© daymade). 206 words, ~993 tokens.

Download SKILL.mdSave it as .claude/skills/read-docx-review/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
read-docx-review
description
读取 Word/WPS 审阅后的 docx,把批注(comments)与修订(track changes)提取成可逐条裁决的 markdown 对账表或 JSON。触发场景:对方批注完的合同/协议/书稿/报告回来了要读意见;「提取 docx 批注」「审阅意见对账」「读一下修订」「谁批了什么、批在哪」;WPS 云文档/Word 在线协作 导出的审阅稿;收到带修订模式改动的回稿要看对方改了什么。核心保证:修订感知——python-docx 裸读会漏掉修订插入(w:ins)的内容、认不出整段删除(w:del),本 skill 走 OpenXML SDK 引擎 不漏。只读,不改对方文件。边界:生成/排版 docx → docx-creator 或 minimax-docx;PDF 批注不在范围。
disable-model-invocation
true

read-docx-review — docx 批注与修订对账

一条命令把审阅过的 docx 读成对账表:谁批的、批在哪段、批了什么、处理状态,外加修订模式的 逐段删改。产出表格自带空白「处置」列——它的用途就是拿去逐条裁决。

引擎提炼自作者一个真实图书出版项目的审阅工具链(2026-02 起生产验证:单文件 96 条编辑批注、 整书修订处理、输入含 WPS 云文档导出件),此处为通用化版本。书稿级的深度编辑工作流(版本链、 批注 resolve 状态机、审阅看板)留在原项目(私有),不在本 skill 范围。

快速开始

本文全部命令都假设工作目录是本 skill 根目录(scripts/ 是相对路径)——先 cd 过来, 或把 scripts/… 换成绝对路径;docx 参数无所谓相对绝对。

bash
uv run python scripts/extract_review.py <审阅稿.docx>

预期输出(有批注时):

# 审阅对账 · 某某协议-审阅版.docx

批注 12 条(未处理 10 / 已处理 2,其中回复 1 条);修订段落 3 个(删除元素 2、插入元素 4)。

## 批注

| # | 批注人 | 时间 | 锚定段落 | 批注内容 | 状态 | 处置 |
|---|---|---|---|---|---|---|
| 0 | 张三 | 2026-02-14 16:02 | 乙方应于收到通知后 15 个工作日内… | 15 天太短,建议 30 天 | 未处理 |  |
| ↳1 | 李四 | 2026-02-14 18:11 | (回复 #0) | 同意,30 天合理 | 未处理 |  |

## 修订(track changes)

| 段落 | 删除 | 插入 | 处置 |
|---|---|---|---|
| 47 | 百分之十五 | 百分之十 |  |

无批注无修订时输出一段明确提示(「这份 docx 没有携带任何审阅痕迹」+两个常见原因), 不会静默输出空表——拿到丢了批注的副本还以为对方没意见,比读错内容更危险。

变体:

bash
# 机器可读全量(锚定段落不截断、含全部字段)
uv run python scripts/extract_review.py <docx> --json

# 对账表包含已处理(resolved)的批注(默认只列未处理)
uv run python scripts/extract_review.py <docx> --include-resolved

要看某条批注前后更多上下文段落(对账表锚定列截断到 60 字,--json 里是全文):

bash
uv run python -c "
import sys; sys.path.insert(0, 'scripts')   # 同样假设 cwd = skill 根目录
from bridge_lib.docx_bridge_client import extract_views
for v in extract_views('<docx>', paragraph_range=(40, 55)):  # 批注锚定段落 ±N
    print(v['index'], v['display'][:100])"

为什么必须走这套引擎(不要退回 python-docx 裸读)

python-docx 的 paragraph.text 走 paragraph.runs,runs 只取直接子 <w:r>、不递归 <w:ins> 包装——对方用修订模式插入的所有内容都会被漏读;裸 lxml 的 .//w:t 能读到 ins,但认不出「段落标记被 <w:del> 包装的整段」(接受修订后会整段消失的内容仍有 <w:t>)。 两个方向的漏读都在真实出版审阅稿上踩过。本 skill 的 csx 引擎基于 Word 工程团队 官方维护的 OpenXML SDK,ins/del/move 是一等公民。机制细节、段落索引语义(body 直接子段, 与 python-docx 对齐、不递归表格内段)与三个 csx 的出参规格见 references/csharp-tasks-spec.md。

scripts/bridge_lib/docx_bridge_client.py 是 Python 入口层:list_comments() / list_revisions() / extract_views() / paragraph_text(),全部无状态直读 docx,按 (路径+mtime) 做内存缓存。写自定义分析时 import 它,别绕过它手解 XML。

依赖(首次使用装一次)

bash
brew install dotnet                      # 或已有任意 .NET SDK
dotnet tool install -g dotnet-script    # csx 运行时
  • DOTNET_ROLL_FORWARD=Major 已由 client 内置设置(本机 .NET 版本高于 csx 目标版本时自动兼容)。
  • ~/.dotnet/tools 不在 PATH 时 client 会自动补,无需手动 export。
  • NuGet 包(DocumentFormat.OpenXml 3.2.0,csx 内 #r 声明)首跑自动 restore,需要网络, 首次运行慢约 10-30 秒属正常;之后走本地包缓存。
  • Python 侧纯 stdlib,零第三方依赖(解析全部在 C# 侧完成,Python 只做编排与渲染)—— uv run python 或系统 python3 都能跑。

Troubleshooting

症状原因处理
csx script failed … dotnet-script: command not founddotnet-script 未装上面依赖节两条安装命令
首次运行卡 10-30 秒NuGet 首次 restore正常,等它;离线环境会失败,需联网首跑一次
批注 0 条,但对方说批过拿到的副本导出时丢了批注;或对方批在在线文档上没导出让对方重新「下载/另存为 docx」。WPS 云文档的「下载为 docx」实测保留批注与 resolved 状态(2026-03 一份真实出版审阅稿的 96 条批注即此来源;本 skill 的空结果提示也会提醒这一条)
批注在,但「按章节筛选」类需求做不了文档没用 Word Heading 样式(很多生成器直排文本)用锚定段落号定位;对账表本身不受影响
修订表为空,但 Word 里能看到红字改动那份文件的改动已被接受/拒绝过,红字是比较视图修订只存在于未接受的 track changes;让对方发未接受修订的原稿

设计边界(防止未来重新纠结)

  • Python 生态有 docx-revisions、docx-editor、docx2python 等批注/修订库(2026-08 核实存在)。 未采用:本引擎已在真实出版审阅流程生产验证,且 OpenXML SDK 是官方实现、修订语义保真度 上限更高;社区库对 python-docx 的补丁层未经我们验证,为已解决的问题重做验证是负收益。
  • 本 skill 只读。它不提供「接受/拒绝修订」「回复批注」「改正文再导出」——对账后的改动应落在 你自己的正稿源(合同草案 SSOT、书稿源文件)再重新生成,而不是在对方的审阅副本上改。
  • PDF 批注、飞书/腾讯文档在线批注不在范围(各有专属工具链)。

Next Step

对账表出来后的常见下游:逐条裁决由文档 owner 做(表格的「处置」列);需要改合同/协议/书稿 正稿并重新生成对外件时,走你自己项目的起草与重新生成流程——本 skill 刻意不碰改稿。

© daymade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in daymade-docs/read-docx-review of daymade/claude-code-skills.

  • SKILL.md
  • references/csharp-tasks-spec.md
  • scripts/bridge_lib/__init__.py
  • scripts/bridge_lib/docx_bridge_client.py
  • scripts/csharp/tasks/extract_views.csx
  • scripts/csharp/tasks/list_comments.csx
  • scripts/csharp/tasks/list_revisions.csx
  • scripts/extract_review.py

Open the folder on GitHubat commit 0e52df5

Compare with similar skills

Read DOCX Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Read DOCX Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Read DOCX Review this skilldaymade/claude-code-skills1.4k—~993Automated safety check: PassMIT
Minimax DOCXpoco-ai/poco-claw1.4k7 repos~3.9kAutomated safety check: PassMIT
Toxynissl-lab/toxy463—~1.7kAutomated safety check: PassApache-2.0
DOCXLeastBit/Claude_skills_zh-CN590—~1.3kAutomated safety check: NotesProprietary
Word Document Creation And Editingpipeshub-ai/pipeshub-ai3.8k—~1.3kAutomated safety check: PassApache-2.0
Office DOCXsingula-ai/alego1091 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Minimax DOCX

    poco-ai/poco-claw

    Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET).

    1.4k GitHub starsUsed in 7 repos~3.9k tokens
    Documents & OfficeAuto-check passed
  • Toxy

    nissl-lab/toxy

    A skill your agent uses whenever the user wants to extract text or data from documents using Toxy (the .NET text extraction library).

    463 GitHub stars~1.7k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • DOCX

    LeastBit/Claude_skills_zh-CN

    全面的文档创建、编辑和分析功能,支持修订追踪、批注、格式保留和文本提取。当 Claude 需要处理专业文档(.docx 文件)时使用:(1) 创建新文档,(2) 修改或编辑内容,(3) 处理修订追踪,(4) 添加批注,或其他任何文档任务

    590 GitHub stars~1.3k tokensUpdated 8 mo ago
    Documents & OfficeAuto-check: notes
  • Word Document Creation And Editing

    pipeshub-ai/pipeshub-ai

    Routes a Word document request to the right approach: a TypeScript library for new files, XML editing for existing ones, and plain reading only.

    3.8k GitHub stars~1.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Office DOCX

    singula-ai/alego

    Create, read, edit, and check Word documents (.docx), including reports, letters, and formatted tables.

    109 GitHub starsUsed in 1 repo~1.5k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed

More from daymade/claude-code-skills

All 104 skills in this repo
  • Video Comparer

    daymade/claude-code-skills

    This skill should be used when comparing two videos to analyze compression results or quality differences.

    1.4k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check: notes
  • CLI Demo Generator

    daymade/claude-code-skills

    Generates professional animated CLI demos as GIFs using VHS terminal recordings.

    1.4k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Doc To Markdown

    daymade/claude-code-skills

    Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.

    1.4k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Interaction Design Board

    daymade/claude-code-skills

    Generates several distinct, clickable HTML interaction prototypes for one product surface into a Design Board and collects selection/remix feedback before implementation.

    1.4k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Skill Creator

    daymade/claude-code-skills

    Creates, edits and benchmarks skills; supersedes the official skill-creator plugin, so when both are listed, use this one.

    1.4k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Auto Repo Setup

    daymade/claude-code-skills

    Diagnoses and repairs repository setup and guarded Git workflows for Claude Code or Codex — environment repair, startup sync, hook auditing, collaborator handoff.

    1.4k GitHub stars~2.9k tokensUpdated today
    Auto-check: notes

Questions about Read DOCX Review

What does Read DOCX Review do?

读取 Word/WPS 审阅后的 docx,把批注(comments)与修订(track changes)提取成可逐条裁决的 markdown 对账表或 JSON。触发场景:对方批注完的合同/协议/书稿/报告回来了要读意见;「提取 docx 批注」「审阅意见对账」「读一下修订」「谁批了什么、批在哪」;WPS 云文档/Word 在线协作…. Read DOCX Review is an agent skill from daymade/claude-code-skills.

When should I use Read DOCX Review?

Read DOCX Review fits situations like: tasks that involve Word documents.

How do I install Read DOCX Review in Claude Code?

Run `npx skills add daymade/claude-code-skills --skill read-docx-review -a claude-code`. Or copy the skill folder (daymade-docs/read-docx-review in daymade/claude-code-skills) into .claude/skills/read-docx-review in your project. Claude Code loads it when a task matches its description.

How do I install Read DOCX Review in Codex?

Run `npx skills add daymade/claude-code-skills --skill read-docx-review -a codex`. Or copy the skill folder (daymade-docs/read-docx-review in daymade/claude-code-skills) into .agents/skills/read-docx-review in your project. Codex loads it when a task matches its description.

Can I use Read DOCX Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add daymade/claude-code-skills --skill read-docx-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/read-docx-review, .gemini/skills/read-docx-review, .github/skills/read-docx-review and .opencode/skills/read-docx-review in your project.

What does Read DOCX Review need to run?

Going by SKILL.md and its folder, Read DOCX Review needs Python for the scripts in its folder and the command-line tools its instructions call (uv, brew and dotnet). Our summary lists: Python 3.

Does Read DOCX Review access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Read DOCX Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Read DOCX Review use?

Read DOCX Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Read DOCX Review use?

About 993 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Read DOCX Review?

Skills that share tags, products or a category with Read DOCX Review: Minimax DOCX (poco-ai/poco-claw, 1.4k stars), Toxy (nissl-lab/toxy, 463 stars), DOCX (LeastBit/Claude_skills_zh-CN, 590 stars) and Word Document Creation And Editing (pipeshub-ai/pipeshub-ai, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Read DOCX Review?

daymade (a GitHub user) maintains it in daymade/claude-code-skills, which has 1,448 GitHub stars. The repository holds 104 skills in this directory. The repository was last updated on October 10, 2026.

Source: daymade/claude-code-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.