Docx

About this skill

# DOCX creation, editing, and analysis

Overview

A .docx file is a ZIP archive containing XML files.

Quick Reference

| Task | Approach |

|------|----------|

| Read/analyze content | pandoc or unpack for raw XML |

| Create new document | Use docx-js - see Creating New Documents below |

| Edit existing document | Unpack → edit XML → repack - see Editing Existing Documents below |

Converting .doc to .docx

Legacy .doc files must be converted before editing:

python scripts/office/soffice.py --headless --convert-to docx document.doc

Reading Content

# Text extraction with tracked changes
pandoc --track-changes=all document.docx -o output.md

# Raw XML access
python scripts/office/unpack.py document.docx unpacked/

Converting to Images

python scripts/office/soffice.py --headless --convert-to pdf document.docx
pdftoppm -jpeg -r 150 document.pdf page

Accepting Tracked Changes

To produce a clean document with all tracked changes accepted (requires LibreOffice):

python scripts/accept_changes.py input.docx output.docx

---

Creating New Documents

Generate .docx files with JavaScript, then validate. Install: npm install -g docx

Setup

const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, ImageRun,
        Header, Footer, AlignmentType, PageOrientation, LevelForm

…

Use cases

• **Always use `WidthType.DXA`** — never `WidthType.PERCENTAGE` (incompatible with Google Docs)
• Table width must equal the sum of `columnWidths`
• Cell `width` must match corresponding `columnWidth`
• Cell `margins` are internal padding - they reduce content area, not add to cell width
• For full-width tables: use content width (page width minus left and right margins)
• **Set page size explicitly** - docx-js defaults to A4; use US Letter (12240 x 15840 DXA) for US documents

Installation

1. Download the ZIP using the button on the right.
2. Unzip the folder.
3. Drop the docx/ folder inside ~/.claude/skills/.
4. Restart Claude Code (or your Claude Desktop session) — the skill loads automatically.

# macOS / Linux
mkdir -p ~/.claude/skills
unzip claude-skill-docx.zip -d ~/.claude/skills/

What's included

Frequently asked