docx-ru

DOCX (Windows + Cyrillic)

Two CLI scripts on top of Python (read) and docx-js (write). Works on Windows, doesn't crash on cp1251, doesn't require pandoc / soffice.

When to use

• The user attached a .docx file and wants its content extracted
• Need to generate a letter / commercial offer / spec / report as .docx
• Need to save your work as a real Word document, not markdown

For tracked changes, comments, or find-and-replace inside existing documents - use the official anthropic-skills:docx instead.

Reading

python "<SKILL_DIR>/scripts/read_docx.py" "/absolute/path/to/file.docx"

Where <SKILL_DIR> is typically:

• Linux / macOS: ~/.claude/skills/docx-ru
• Windows: %USERPROFILE%\.claude\skills\docx-ru

Output is plain text split by paragraphs (UTF-8 stdout). Add --tables to render tables as pipe-separated rows: cell | cell | cell.

Creating

1. Write a JSON config with blocks (see schema below) using the Write tool. A typical scratch path is ./_tmp_docx.json.
2. Run the builder:

node "<SKILL_DIR>/scripts/build_docx.js" --config "./_tmp_docx.json" --out "./result.docx"

The script automatically replaces em-dashes and en-dashes with regular hyphens so generated text doesn't look AI-written. Pass --keep-dashes to disable.

JSON config schema

{
  "font": "Arial",
  "fontSize": 22,
  "pageSize": "A4",
  "margins": 1134,
  "blocks": [
    { "type": "h1", "text": "Heading 1" },
    { "type": "h2", "text": "Heading 2" },
    { "type": "p",  "text": "Regular paragraph", "bold": false, "italic": false, "center": false },
    { "type": "pRich", "runs": [
        { "text": "Bold fragment: ", "bold": true },
        { "text": "and the rest in plain text." }
      ]
    },
    { "type": "bullet", "text": "Bulleted list item" },
    { "type": "number", "text": "Numbered list item" },
    { "type": "divider" },
    { "type": "image", "path": "./logo.png", "width": 300, "center": true },
    { "type": "table",
      "widths": [3600, 2700, 2700],
      "header": ["Column 1", "Column 2", "Column 3"],
      "rows": [
        ["cell", "cell", "cell"]
      ],
      "firstColBold": true,
      "shadeHeader": "E8E8E8"
    }
  ]
}