docx-deltalisted
Install: claude install-skill smorrel1/claude-code-skills
# Word document delta
```bash
D=~/.claude/skills/docx-delta/scripts/docx_delta.py
python3 $D old.docx new.docx # counts, to the terminal
python3 $D old.docx new.docx -o delta.docx # redline, tracked changes
python3 $D old.docx new.docx -o delta.html # side-by-side, for reading
python3 $D old.docx new.docx --md # unified text diff
python3 $D old.docx new.docx --pair similarity -o delta.html # see below
```
## Which output
- **`.docx`** when you or a recipient will work in Word. It is the new document
with the differences as real `w:ins` and `w:del`, so Review shows them and Accept
and Reject work. This is what Word's own Compare produces.
- **`.html`** when the delta is for reading or for an email. One row per change, old
and new side by side, changed words marked within the paragraph so a single edited
figure is visible in a long paragraph.
- **`--md`** when the answer is a quick "what moved" in the terminal.
Quote the counts it prints (changed, added, deleted, unchanged) when reporting, and
name the two files compared.
## Why not LibreOffice or Word
LibreOffice's compare is the obvious automation route and it does not run reliably
headless. It was built after LibreOffice's compare refused to run for a document delta
that was due to go out in an email, leaving a stale delta about to be sent. Driving Word
by AppleScript needs Word open and focused, which is no good in a background session.
This tool does the c