Word Document Formatting for Codex

A reusable Codex Skill for turning already-structured content into polished, consistent Microsoft Word documents—without rewriting the content or changing the document structure.

It is designed for internal documents such as PRDs, solution proposals, execution summaries, one-pagers, technical briefs, and decision documents.

The default visual system is Apple Inc-inspired: near-black typography, generous whitespace, parchment and pearl surfaces, a monochrome table system, and Apple Action Blue as the single accent. Typography remains Segoe UI to support the team's Word-document standard.

This is an independent community project. It is not affiliated with, endorsed by, or sponsored by Apple Inc. “Apple” is used only to describe a visual design influence.

What it does

• Formats Word documents without changing wording, meaning, or section order.
• Applies A4 paper and Word's Moderate margin geometry.
• Enforces Segoe UI across document defaults, styles, runs, tables, headers, footers, list markers, and theme declarations.
• Provides a complete title and heading hierarchy from Title through Heading 4.
• Adds a transparent two-column metadata block for Author, Last updated, and Reviewer.
• Applies a single consistent table palette across every data table in a document.
• Provides native three-level bullets and numbering with equal indentation steps.
• Supports theme adaptation through awesome-design-md while preserving Word-specific layout and accessibility rules.
• Includes an automated DOCX audit for fonts, title borders, table consistency, and multilevel list definitions.

Install

Copy the Skill folder into your Codex Skills directory:

cp -R word-doc-formatting ~/.codex/skills/word-doc-formatting

The Skill becomes available to Codex on the next task.

Use

Invoke the Skill explicitly:

Use $word-doc-formatting to format this PRD as a polished Word document.
Preserve all wording and section structure.

Format an existing DOCX:

Use $word-doc-formatting to standardize this Word document.
Keep the content unchanged and apply the default Apple-inspired theme.

Use another design direction:

Use $awesome-design-md to select a suitable visual system,
then use $word-doc-formatting to adapt it to Word.
Keep Segoe UI, the page layout, and the document structure unchanged.

For best results, tell Codex:

1. Whether it is creating a new DOCX or formatting an existing one.
2. Whether content and structure must remain unchanged.
3. Whether to use the default Apple-inspired theme or another named direction.
4. The Author, Last updated, and Reviewer values.
5. Where the final DOCX should be saved.

Design system

Fixed Word rules

• A4 portrait by default.
• Margins: 2.54 cm top/bottom and 1.91 cm left/right.
• Segoe UI throughout.
• Title 20 pt; Heading 1–4 at 16/14/12/11 pt; body 10.5 pt.
• No decorative line after the document title.
• Transparent 3 × 2 metadata table.
• Native three-level bullets and decimal numbering.
• Repeating table headers and rows that do not split across pages.
• Render-and-review before delivery.

Default Apple-inspired tokens

Role	Value
Action accent	#0066CC
Primary ink	#1D1D1F
Muted ink	#7A7A7A
Table header	#333333
Parchment surface	#F5F5F7
Pearl surface	#FAFAFC
Hairline	#E0E0E0

All data tables in one document use the same tonal family and shared configuration.

Repository structure

word-doc-formatting/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── assets/
│   └── internal-word-formatting-template.docx
├── references/
│   └── formatting-spec.md
└── scripts/
    └── audit_docx_format.py

Validate a document

python3 word-doc-formatting/scripts/audit_docx_format.py output.docx

The audit checks:

• Segoe UI declarations throughout the DOCX package.
• No visible border on the Title paragraph.
• Consistent data-table palettes.
• Repeating table header rows.
• Complete three-level bullet and number definitions.
• Equal list indentation increments and hanging indents.

Font note

The template declares Segoe UI everywhere. Segoe UI is a Microsoft proprietary font and is not bundled with this repository. Install it through a properly licensed Microsoft product or supply licensed font files on the machine generating or viewing the document. When Segoe UI is unavailable, Word or LibreOffice may display a substitute even though the DOCX declarations are correct.

License

MIT License. See LICENSE.