word-documents

Word Documents

When to Use

Tool	Use When
create_word_document	User asks to create/generate a NEW Word document
modify_word_document	User asks to edit/update an EXISTING document or add content
list_my_word_documents	User asks what documents are available
read_word_document	User wants to download a document or read its comments
preview_word_page	Check actual page appearance (charts, images, complex layouts)

Workflow

1. Before modifying: call preview_word_page to check current layout.
2. After creation/modification: call preview_word_page to verify.
3. Run tools sequentially (never parallel) to prevent file race conditions.

Page Setup

python-docx defaults to A4. For US Letter size:

from docx.shared import Inches
section = doc.sections[0]
section.page_width = Inches(8.5)
section.page_height = Inches(11)
# Set 1-inch margins
section.top_margin = Inches(1)
section.bottom_margin = Inches(1)
section.left_margin = Inches(1)
section.right_margin = Inches(1)

Professional Formatting

• Font: Arial as default. Set via style.font.name = 'Arial'.
• Headings: Use proper heading styles for TOC compatibility: doc.add_heading('Title', level=1) or doc.add_paragraph(style='Heading 1').
• Bullet lists: doc.add_paragraph(style='List Bullet'). NEVER insert unicode bullet characters.
• Numbered lists: doc.add_paragraph(style='List Number').
• Always preserve existing styles, fonts, and colors when modifying.

Images

from docx.shared import Inches
paragraph = doc.add_paragraph()
run = paragraph.add_run()
run.add_picture('file.png', width=Inches(6))

Code Rules

• The document is pre-initialized as doc = Document() (create) or loaded as doc (modify). Do NOT include Document() or doc.save().
• Available libraries: python-docx, matplotlib, pandas, numpy (seaborn NOT available)
• Use add_paragraph(style='List Bullet') for bullet lists. NEVER insert unicode bullet characters.
• NEVER use paragraph.text = 'new text' (destroys formatting). Use runs instead.
• Filenames: letters, numbers, hyphens only.