comment-on-docx

Add editorial comments to Microsoft Word .docx documents while preserving the original file.

9|2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/tim-hua-01/comment-on-docx --skill comment-on-docx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comment-on-docx
Source: https://github.com/tim-hua-01/comment-on-docx/tree/main/comment-on-docx
Command: npx skills add https://github.com/tim-hua-01/comment-on-docx --skill comment-on-docx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, lxml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Drafts and inserts thoughtful, editorially aligned comments into Microsoft Word (.docx) documents without altering the original file, producing a separate reviewed copy.

Core Features & Use Cases

  • Read document runs (including text in figures, tables, and footnotes) and identify feedback opportunities
  • Draft and apply inline and top-level comments in batch, with optional precise text targeting via subset_text
  • Save a new "commented" copy while preserving the original and reuse guidelines from references/commenting.md

Quick Start

Upload your Word document and run the provided scripts to generate a commented copy that preserves the original.

Frequently Asked Questions about comment-on-docx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically add comments to a Word document?

Automated Word doc commenting analyzes your .docx file to draft and insert structured editorial feedback into text, tables, and footnotes. It processes feedback opportunities in batch and saves a newly annotated copy without altering the original file.

Can I add inline feedback to specific text in a docx file using Python?

You can add inline feedback to specific text in a docx file using Python and the python-docx library. This Skill reads document runs and optionally subsets text for precise targeting before batch-applying comments to generate an annotated copy.

Does python-docx support commenting on text inside tables and footnotes?

Yes, python-docx supports commenting on text inside tables and footnotes. This Skill reads content from figures, tables, and footnotes to identify feedback opportunities and applies inline comments accordingly during the batch-processing review.

What is the best way to batch-insert editorial feedback into Word documents?

Batch-inserting editorial feedback into Word documents is best handled by scripts that read document runs and apply comments in batch. This Skill drafts structured feedback across text, structure, and formatting, saving a reviewed copy while adhering to editorial guidelines.

Are there limitations when using Python to comment on Word docx files?

A limitation when using Python to comment on Word docx files is the dependency on the python-docx library and lxml for parsing document runs. The Skill addresses this by saving a separate annotated copy, ensuring the original source file remains unmodified during the batch commenting process.