docx-skill

Use the docx npm package (docx-js) to build a Document object with sections, paragraphs, tables, and images, then write it with Packer.toBuffer. Always set the page size explicitly since docx-js defaults to A4, and validate the output file afterward.

Unpack the .docx into XML, then wrap inserted text in w:ins elements and deleted text in w:del elements with w:delText, including author and date attributes. Replace entire w:r run elements rather than injecting tags inside runs, and preserve the original w:rPr formatting.

Tables break when using WidthType.PERCENTAGE or when cell widths are missing. Always use WidthType.DXA, set both the table columnWidths array and each cell's width so they sum exactly to the table width, and use ShadingType.CLEAR instead of SOLID.

Yes, convert legacy .doc files using LibreOffice headless mode with the command soffice --headless --convert-to docx. The included soffice.py helper handles sandboxed environments where Unix sockets are blocked.

Run the accept_changes.py script, which uses a LibreOffice Basic macro to accept all tracked changes and save a clean document. It requires LibreOffice installed and produces a new output file without modifying the original.

Do not use it for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to Word documents. Direct XML editing also cannot auto-repair malformed XML, invalid element nesting, or missing relationships, so those must be fixed manually.