DOCX

Use this skill for .docx work. A .docx file is a ZIP archive of XML parts, so creation and editing require validation after changes.

Workflow

1. Choose the task path.
   • Read or analyze: use pandoc first, or unpack XML when tracked changes, comments, or formatting matter.
   • Create from scratch: use docx for JavaScript and follow references/creation.md.
   • Edit an existing file: unpack, edit XML, repack, and validate with references/editing.md.
   • Add tracked changes, comments, images, or OOXML details: read references/xml-reference.md.
   • Validate visual output or convert formats: use references/qa.md.
2. Preserve the original file. Write output to a new path unless the user explicitly asks to overwrite.
3. Use the bundled clean-room OOXML helper before falling back to raw ZIP commands: python <skill-dir>/scripts/ooxml_tool.py --help.
4. Use python <skill-dir>/scripts/docx_text.py --help for comments/tracked-change inspection and exact text-node replacement.
5. Use python <skill-dir>/scripts/docx_comments.py --help to add comments by exact text target (supports cross-run boundaries).
6. Use python <skill-dir>/scripts/docx_track_changes.py --help to programmatically accept or reject all simple tracked changes.
7. Validate generated or edited files before reporting success.