docx
Installation
SKILL.md
Part 1: Goals
⚠️ When to Unzip vs Read
To preserve ANY formatting from the source document, MUST unzip and parse XML.
Read tool returns plain text only — fonts, colors, alignment, borders, styles are lost.
| Need | Method |
|---|---|
| Text content only (summarize, analyze, translate) | Read tool is fine |
| Formatting info (copy styles, preserve layout, template filling) | Unzip and parse XML |
| Structure + comments/track changes | pandoc input.docx -t markdown |
Core Principles
-
Preserve formatting — When editing existing documents, retain original formatting. Clone and modify, never recreate.
-
Correct feature implementation — Comments need multi-file sync. Track Changes need revision marks. Use the right structure.