docx - SKILL.md Agent Skill

name: docx description: "Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks" license: Proprietary. LICENSE.txt has complete terms

DOCX Toolkit

Use this skill for Word document creation, extraction, OOXML edits, tracked changes, comments, formatting preservation, and document-to-image conversion.

Choose Path

Read/analyze text: convert with pandoc --track-changes=all input.docx -o current.md.
Create new document: read relevant parts of docx-js.md, then use JavaScript docx (Document, Paragraph, TextRun, Packer).
Edit your own/simple document: use OOXML helpers from ooxml.md and scripts/document.py.
Edit third-party, legal, business, academic, or government docs: use tracked changes workflow.
Comments, media, metadata, complex formatting: unpack and inspect raw OOXML.
Visual review: convert DOCX to PDF with LibreOffice, then PDF pages to images with Poppler.

References

Open only what task needs:

docx-js.md: document creation syntax, styles, lists, tables, page breaks.
ooxml.md: unpack/edit/pack, Document library, comments, tracked changes, validation, raw XML patterns.

Scripts

ooxml/scripts/unpack.py <office_file> <output_dir>
ooxml/scripts/pack.py <input_dir> <office_file>
ooxml/scripts/validate.py <office_file>
scripts/document.py: high-level OOXML document editing library.

Run script --help first when available.

Tracked Changes Workflow

Convert source to markdown with tracked changes visible.
Identify all requested edits and group into small batches by section, type, or proximity.
Read relevant ooxml.md sections for Document library and tracked-change patterns, then unpack the DOCX.
Before each batch, grep word/document.xml for current target text; markdown line numbers do not map to XML.
Mark only changed text with <w:del>/<w:ins>. Preserve unchanged runs where practical so redlines stay reviewable.
Pack, convert back to markdown, validate all intended edits, and check no unintended text changed.

Code Style

Keep scripts short, deterministic, and low-noise. Avoid broad rewrites of OOXML. Batch changes so failures are easy to isolate.