| name | office-docx |
| description | Create, edit, inspect, format, template, and validate Microsoft Word .docx files with task-specific .NET and OpenXML SDK implementations. Use for Word/DOCX work: reports, manuscripts, contracts, proposals, formal documents, text replacement, placeholder filling, tables, images, sections, headers/footers, page numbers, TOC, template formatting, CJK document layout, or DOCX repair. |
Office DOCX
Use this skill for Word .docx tasks. Implement with C# on .NET + OpenXML SDK.
Operating Model
dotnet from PATH; NuGet package DocumentFormat.OpenXml.- Copy
assets/dotnet-starter/ as starting point when useful.
- Preserve source document; write result to a separate
.docx.
- Keep content editable (paragraphs, runs, tables, styles, fields, drawings).
Task Selection
| Task | Read | Focus |
|---|
| Create new document | references/create-docx.md | Package, body, styles, page setup, tables, images, fields |
Edit existing .docx | references/edit-existing-docx.md | Copy to output, inspect, modify content |
| Apply/imitate template | references/template-formatting.md | Transfer styles/theme/numbering safely |
| Validate/repair | references/validation.md | OpenXML validation, package inspection |
| Structural rules | references/openxml-rules.md | Element ordering, units, sections, tables |
Read the matching reference, implement, run, validate with scripts/check-docx.py.
Key Rules
- Use SDK classes, not raw ZIP string edits.
- Text replacement: single-run matches only; multi-run → paragraph-level rewrite.
- Generated docs: define styles first, then content via style IDs.
- CJK: set East Asian fonts in
RunFonts; confirm spacing and hierarchy.
- Final
sectPr must be last child of w:body.
