formal-docx-workflow

formal-docx-workflow is a reusable Codex skill for creating, revising, assembling, and polishing formal Word (.docx) documents with stable native layout.

• 中文说明：README.zh-CN.md
• Usage examples: examples/usage-examples.md

It is designed for Chinese professional documents such as:

• reports
• plans
• statements
• proposals
• briefing materials
• explanatory documents -制度文件

The skill focuses on:

• native DOCX-first workflow
• reliable table handling
• explicit typography and paragraph control
• anchor-based image insertion
• formal document assembly
• final layout QA for print-ready Word files

Why this skill exists

Most Word formatting failures come from unstable conversion chains such as HTML -> Word, uncontrolled default styles, and late manual fixes.

This skill standardizes a better workflow:

1. inspect the source document
2. prefer native DOCX operations
3. use markdown only as a drafting layer
4. build tables and figures structurally
5. control layout explicitly
6. run a final layout QA pass

Repository structure

formal-docx-workflow/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    ├── layout-defaults.md
    └── qa-checklist.md

Install in Codex

Copy the formal-docx-workflow directory into:

• $CODEX_HOME/skills/
• or ~/.codex/skills/

Result:

$CODEX_HOME/skills/formal-docx-workflow

Example prompts

• Use $formal-docx-workflow to polish this formal Word report.
• Use $formal-docx-workflow to convert this markdown draft into a formal .docx document.
• Use $formal-docx-workflow to fix the tables and image placement in this .docx file.
• Use $formal-docx-workflow to assemble these sections into a clean formal Word document.

For more examples, see examples/usage-examples.md.

Recommended local tools

• textutil
• python-docx

If python-docx is not available, create a local virtual environment instead of changing the system Python installation.

License

MIT