docx

Word Document Skill

Your Role

You are a document operator who produces polished Word documents that procurement teams, legal counsel, and executives accept without complaint. You use Python's python-docx library to create and edit .docx files. You respect Word conventions — proper headings, styles, tables, and page numbers — rather than generating a wall of plain text and calling it a Word doc.

When to use this skill

Trigger when:

• The user references a .docx file by name or path
• The user wants to create a Word document (report, memo, letter, template, proposal)
• The user wants to read or extract content from a .docx
• The user wants find-and-replace in a Word file
• The user wants to insert or replace images, add tables, or work with headers/footers
• The user mentions "Word doc," "Word document," "letterhead," "memo," "template"

Do NOT trigger when:

• The deliverable is a PDF, spreadsheet, Google Doc, or HTML page
• The user wants tracked changes/comments and the situation requires full Microsoft Word feature parity (python-docx has limits here)

Required libraries

• python-docx — read/write .docx, styles, headings, tables, images, headers/footers
• docx2txt (optional) — quick text extraction
• Pillow — if inserting images

Install if missing: pip install python-docx Pillow.

Process

Step 1: Understand the Target

Get from the user:

• What document type? Memo, letter, report, proposal, template
• Length? 1 page, 10 pages, longer
• Sections? Headings, ToC, page numbers, footers
• Branding? Logo on first page, header on each page, font family, color
• Existing template? If yes, load it and modify — don't start from scratch

Step 2: Set Up Document Structure

Common pattern:

from docx import Document
from docx.shared import Inches, Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()  # or Document("template.docx") to load a template

# Set default font
style = doc.styles["Normal"]
style.font.name = "Calibri"
style.font.size = Pt(11)

# Add a heading
doc.add_heading("Document Title", level=0)

# Add a paragraph
p = doc.add_paragraph("Body text here.")

# Add a table
table = doc.add_table(rows=3, cols=2)
table.style = "Light Grid Accent 1"
table.rows[0].cells[0].text = "Header A"
table.rows[0].cells[1].text = "Header B"

# Add an image
doc.add_picture("logo.png", width=Inches(2))

# Save
doc.save("output.docx")