The Complete Production SOP: How to Deploy and Run Word & Docx Document Stylist in Autonomous AI Agents

---
name: "documents"
description: "Create, format, redline, and comment on .docx Word and Google Docs files with visual QA."
runtime_dependencies:
  python:
    - "python-docx>=1.1.0"
    - "docx2pdf>=0.1.8"
---

# Word & Docx Document Stylist Rulebook
- Always inspect existing docx styles before appending new runs.
- Use explicit Pt() and Inches() measurements; avoid hardcoded integer Twips.
- Redline edits must preserve w:author, w:date, and w:id attributes.
- Run headless docx2pdf conversion to inspect page breaks before completing task.

import docx
from docx.shared import Inches, Pt, RGBColor

def test_init():
    doc = docx.Document()
    section = doc.sections[0]
    section.top_margin = Inches(1.0)
    section.bottom_margin = Inches(1.0)
    p = doc.add_paragraph()
    run = p.add_run('QA Verification Probe')
    run.font.name = 'Arial'
    run.font.size = Pt(11)
    run.font.color.rgb = RGBColor(0x11, 0x18, 0x27)
    doc.save('test_probe.docx')
    print('python-docx engine verified.')

if __name__ == '__main__':
    test_init()

from docx.oxml import OxmlElement
from docx.oxml.ns import qn

def set_cell_background(cell, hex_color):
    tcPr = cell._tc.get_or_add_tcPr()
    shd = OxmlElement('w:shd')
    shd.set(qn('w:val'), 'clear')
    shd.set(qn('w:color'), 'auto')
    shd.set(qn('w:fill'), hex_color)
    tcPr.append(shd)

def create_callout_box(doc, text, hex_color="F3F4F6"):
    table = doc.add_table(rows=1, cols=1)
    table.autofit = False
    cell = table.cell(0, 0)
    cell.text = text
    set_cell_background(cell, hex_color)

#!/usr/bin/env bash
set -euo pipefail

TARGET="contracts/msa_template.docx"

# 1. OpenXML structure assertion
python -c "import docx; doc = docx.Document('$TARGET')"

# 2. Convert to PDF to ensure no layout corruption
if command -v libreoffice &> /dev/null; then
  libreoffice --headless --convert-to pdf "$TARGET" --outdir ./dist/
  echo "QA Gate Passed: Visual rendering verified."
else
  echo "Warning: libreoffice not present, skipping visual PDF gate."
fi