mcpField
W
word

word

github.com/igorwarzochaDocuments122774 installsUpdated 38w ago
Repository

About word

A skill for creating, editing, reviewing, and extracting content from Word documents. It emphasizes rendering documents to images for visual inspection and supports tracked changes through document XML workflows.

Key features

  1. 01Create documents with python-docx or docx-js
  2. 02Render documents to PDF and PNG
  3. 03Inspect and correct visual defects
  4. 04Manage tracked changes in XML
  5. 05Extract structured text with Pandoc
  6. 06Check chart and table readability

Use cases

  1. 01Creating professional Word documents
  2. 02Reviewing rendered pages for layout defects
  3. 03Preparing legal or business redlines
  4. 04Converting DOCX content to Markdown

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/igorwarzocha/opencode-workflows --skill word

After installing, type/wordin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
docx-js.md
ooxml.md
references/ooxml/schemas/ecma/fouth-edition/
opc-contentTypes.xsd
opc-coreProperties.xsd
opc-digSig.xsd
opc-relationships.xsd
references/ooxml/schemas/ISO-IEC29500-4_2016/
dml-chart.xsd
dml-chartDrawing.xsd
dml-diagram.xsd
dml-lockedCanvas.xsd
dml-main.xsd
dml-picture.xsd
dml-spreadsheetDrawing.xsd
dml-wordprocessingDrawing.xsd
pml.xsd
shared-additionalCharacteristics.xsd
shared-bibliography.xsd
shared-commonSimpleTypes.xsd
shared-customXmlDataProperties.xsd
shared-customXmlSchemaProperties.xsd
shared-documentPropertiesCustom.xsd
shared-documentPropertiesExtended.xsd
shared-documentPropertiesVariantTypes.xsd
shared-math.xsd
shared-relationshipReference.xsd
sml.xsd
vml-main.xsd
vml-officeDrawing.xsd
vml-presentationDrawing.xsd
vml-spreadsheetDrawing.xsd

Details

From the project README

<quality_workflow> For all professional deliverables, you MUST follow the "Render & Review" loop:

  1. Edit: Use python-docx for structure/styling or the Document library for XML edits.
  2. Render: Convert to PDF/PNG using soffice and pdftoppm:
    • soffice --headless --convert-to pdf document.docx
    • pdftoppm -png -r 150 document.pdf page
  3. Inspect: Read the generated PNG images. You MUST look for clipped text, overlapping shapes, or misaligned margins.
  4. Fix: Address defects and repeat the loop until the document is visually flawless. </quality_workflow>

<technical_workflows>

1. Creating New Documents
  • Python: You SHOULD use python-docx. Establish hierarchy with HeadingLevel styles.
  • JavaScript: You SHOULD use docx-js. Reference: See references/docx-js.md for syntax.
  • CRITICAL: You MUST NOT use \n for line breaks (use Paragraphs). You MUST NOT use Unicode bullets (use numbering config). PageBreak MUST be inside a Paragraph.
2. Redlining & Tracked Changes

For legal or business review:

  • Initialize: Use scripts/document.py. Reference: Read references/ooxml.md for XML patterns.
  • Procedure: Unpack (unpack.py), edit XML using the Document Library, then Pack (pack.py).
  • Standard: You MUST only mark text that actually changes. Keep unchanged text outside <w:del>/<w:ins>.
3. Text Extraction
  • You SHOULD use Pandoc to convert to markdown while preserving structure:
    • pandoc --track-changes=all path-to-file.docx -o output.md </technical_workflows>

<quality_expectations>

  • Client-Ready: You MUST NOT use Unicode dashes (use ASCII hyphens). No internal AI tokens.
  • Element Ordering: In <w:pPr>, elements MUST follow schema order: Style -> Numbering -> Spacing -> Indent -> Alignment.
  • Visual Fidelity: Charts and tables MUST be sharp and legible in rendered previews. </quality_expectations>

</word_document_professional_suite>

Comments

Markdown supported