docx-creator

Microsoft DOCX Colorful Creator

Create enterprise-grade, professional Word documents using the 4-color Microsoft logo palette — a visually vibrant alternative to the standard single-blue ms-docx-creator.

Core Principles — ALWAYS Follow These

Every document created with this skill MUST include:

When to Use This vs ms-docx-creator

Color System

The 4 Microsoft logo colors rotate across sections:

Quick Start

import sys, os
sys.path.insert(0, '<skill-path>/scripts')
from create_colorful_document import MSColorfulDocCreator, Icons

# Logo auto-resolves from assets/ folder, or specify explicitly
doc = MSColorfulDocCreator(
    title="Document Title",
    subtitle="Description of the document",
    version="1.0",
    client="Client Name",                    # Optional
    author="[email protected]",       # Always this
    subject="Topic keywords for properties", # Auto-fills doc properties
    keywords="keyword1, keyword2, keyword3", # Auto-fills doc properties
    category="Workshop Guide",               # Auto-fills doc properties
    logo_path="<skill-path>/assets/logo-msft-github-color-black.png",  # Auto-resolved if omitted
)

# 1. ALWAYS: Cover + TOC + Header/Footer
doc.create_full_document()

# 2. Content with rotating colors
doc.add_executive_summary("Overview text...", color="blue")

doc.add_color_bar()
doc.add_section_heading("Section Title", level=1, color="green")
doc.add_body("Paragraph text...")
doc.add_bullets(["Item 1", "Item 2"])
doc.add_table(
    headers=["Col1", "Col2", "Col3"],
    rows=[["A", "B", "C"], ["D", "E", "F"]],
    color="green"
)

doc.add_color_bar()
doc.add_section_heading("Another Section", level=1, color="yellow")
doc.add_highlight_box("Key Point", "Important content here", color="yellow", icon=Icons.TARGET)
doc.add_key_takeaway("Critical insight...", color="yellow")
doc.add_best_practice("Recommended approach...", color="green")
doc.add_note("Tip: ", "Helpful information", color="blue")
doc.add_diagram_placeholder("Architecture diagram description", color="blue")
doc.add_code_block("print('hello')", language="python")
doc.add_source("Source Name", "https://url.com")
doc.add_icon_list([(Icons.CHECK, "Done"), (Icons.ROCKET, "In Progress")])

# 3. ALWAYS: Closing page with contact and next steps
doc.add_closing_page(
    next_steps=["Step 1", "Step 2", "Step 3"],
    contact_name="Paula Silva",
    contact_email="[email protected]",
    contact_role="Senior Software Engineer | Global Black Belt",
    contact_team="Software GBB Americas",
    github_usernames=["@paulanunes85", "@paulasilvatech"],  # Default if omitted
    additional_contacts=[  # Optional
        {"name": "Colleague", "email": "[email protected]", "role": "Role",
         "github": ["@username"]}
    ]
)

doc.save("/path/to/output.docx")

Dependencies: pip install python-docx lxml

Workflow

1. IDENTIFY document type and target audience
2. GATHER content — NEVER invent information
3. PLAN color assignment: assign each major section a logo color (rotate evenly)
4. CREATE with scripts/create_colorful_document.py:
   a. Initialize with ALL properties (title, subtitle, subject, keywords, category)
   b. create_full_document()  → Cover + TOC + Header/Footer
   c. Add content sections with rich visual elements
   d. add_closing_page()      → Contact + Next Steps
5. SAVE with naming: {name}_v{version}.docx

Document Properties — ALWAYS Fill These

The document properties (File > Properties in Word) MUST be filled:

Visual Elements — Use Generously

Use these elements throughout documents to create professional, enterprise-grade content:

Available Icons (from Icons class)

CHECK ✅    WARNING ⚠️   INFO ℹ️      IMPORTANT ❗   TIP 💡
PIN 📌      ROCKET 🚀    TARGET 🎯    CHART 📊       GEAR ⚙️
LINK 🔗     CALENDAR 📅  PERSON 👤    TEAM 👥        EMAIL 📧
STAR ⭐     CLOCK ⏱️     SHIELD 🛡️    KEY 🔑         ARROW_RIGHT ➡️
PROGRESS 🔄 NEXT ▶️

Color Assignment Strategy

Distribute colors evenly. Default rotation: Blue → Green → Yellow → Red → repeat.

Use doc.next_color() for auto-rotation, or specify explicitly:

doc.add_section_heading("Section", color="blue")    # Explicit
doc.add_section_heading("Section")                   # Auto-rotation

For tables within a section, match the section's color OR use a contrasting one.

Document Structure Standards

For ALL Documents

Cover Page (themed)
Table of Contents
[Version History — if multiple versions]
[Executive Summary — if 5+ pages]
Content Sections (with visual elements)
[Glossary — if technical terms used]
Closing Page (contact + next steps)

Header Format

Line 1: {Title} | Software GBB Americas
Line 2: Version {x.xx} | [email protected]

⚠️ IMPORTANT: Always use "Software GBB Americas" — NEVER "Latam", "LATAM", or "Latam Software GBB".

Content Rules

CRITICAL — Never Invent Information

• Use ONLY information from context, directory, or project knowledge
• ALWAYS cite external sources with doc.add_source()
• If unavailable, state: "Information not available in provided context"

Enterprise Best Practices

• Use tables for ANY structured/comparative data
• Add highlight boxes for key points in every major section
• Include diagrams/flow placeholders where architecture or process is described
• Add icon lists for status tracking and checklists
• Use notes/callouts for tips, warnings, and important information
• Include glossary when 3+ technical acronyms are used
• Add executive summary for documents with 5+ content pages
• Always include next steps on the closing page when actionable items exist

Typography — Segoe UI Family ONLY

All text in the document MUST use Segoe UI and its variations. No other fonts allowed.

Resources

Content truncated.