doc

name	doc
description	Use when the task involves reading, creating, or editing `.docx` documents, especially when formatting or layout fidelity matters; prefer `python-docx` plus the bundled `scripts/render_docx.py` for visual checks.

DOCX Skill

When to use

• Read or review DOCX content where layout matters (tables, diagrams, pagination).
• Create or edit DOCX files with professional formatting.
• Validate visual layout before delivery.

Workflow

1. Prefer visual review (layout, tables, diagrams).
   • If soffice and pdftoppm are available, convert DOCX -> PDF -> PNGs.
   • Or use scripts/render_docx.py (requires pdf2image and Poppler).
   • If these tools are missing, install them or ask the user to review rendered pages locally.
2. Use python-docx for edits and structured creation (headings, styles, tables, lists).
3. After each meaningful change, re-render and inspect the pages.
4. If visual review is not possible, extract text with python-docx as a fallback and call out layout risk.
5. Keep intermediate outputs organized and clean up after final approval.

Temp and output conventions

• Use tmp/docs/ for intermediate files; delete when done.
• Write final artifacts under output/doc/ when working in this repo.
• Keep filenames stable and descriptive.

Dependencies (install if missing)

Prefer uv for dependency management.

Python packages:

uv pip install python-docx pdf2image

If uv is unavailable: