docx

Create, edit, and analyze .docx files with tracked changes and comments.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-config --skill docx-clay-hhk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docx
Source: https://github.com/Clay-HHK/claude-config/tree/main/skills/docx
Command: npx skills add https://github.com/Clay-HHK/claude-config --skill docx-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires defusedxml, Pillow, lxml, and includes scripts (resource) components.

What problem does it solve?

Working with professional Word documents (.docx) is error-prone and time-consuming when you need to preserve formatting, manage tracked changes, add comments, or validate OOXML structure; this Skill provides deterministic tools and workflows so you can create, edit, and review documents reliably at scale.

Core Features & Use Cases

  • Text extraction & analysis: Convert DOCX to markdown or read raw XML to access comments, metadata, complex formatting, and embedded media.
  • Create new documents: Author .docx files using docx-js with best-practice styles, lists, tables, and images while avoiding common formatting pitfalls.
  • Edit existing documents with tracked changes: Apply the Redlining workflow to plan edits in markdown, implement precise <w:del>/<w:ins> patterns, preserve RSIDs and run-level formatting, and batch changes for safe testing.
  • Comments and review automation: Programmatically add, reply to, and manage comment threads and extensible comment metadata for collaborative review.
  • Validation and packaging: Use built-in validators to ensure [Content_Types].xml, .rels, namespace declarations, and XSD compliance are correct before packing and converting back to .docx.
  • Use cases: Legal redlining of contracts, academic manuscript editing with tracked changes, bulk policy updates preserving formatting, automated insertion or rejection of author changes, and visual verification by converting pages to images.

Quick Start

Unpack the document, convert it to markdown with tracked changes preserved, draft redline batches in markdown, and apply them using the Document library with the suggested RSID for tracked changes.

Frequently Asked Questions about docx

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

FAQPage Schema
How do I apply tracked changes to an existing Word document?

To apply tracked changes to a Word document, you can plan edits in markdown and implement precise <w:del>/<w:ins> patterns to preserve RSIDs and run-level formatting for safe redlining.

Can I programmatically add and manage comments in a .docx file?

Yes, you can programmatically add, reply to, and manage comment threads along with extensible comment metadata in a .docx file to automate collaborative review workflows.

What is the best way to extract text and analyze formatting from DOCX files?

The best way to analyze DOCX files is converting them to markdown or reading raw OOXML to access comments, metadata, complex formatting, and embedded media deterministically.

How do you validate OOXML structure before packaging a .docx file?

To validate OOXML structure before packaging, use built-in validators to ensure [Content_Types].xml, .rels, namespace declarations, and XSD compliance are correct for the .docx file.

Does this approach work for bulk policy updates while preserving formatting?

Yes, this approach works for bulk policy updates by applying deterministic workflows that preserve formatting and metadata while managing tracked changes across multiple documents reliably at scale.