| name | docx-ru |
| description | Read and create .docx files on Windows with proper UTF-8 / Cyrillic support. Lightweight alternative to anthropic-skills:docx without pandoc / LibreOffice dependencies. Use when a .docx file is involved - extracting text or building a document with paragraphs, lists and tables. (Чтение и создание .docx с поддержкой русского.) |
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
- Write a JSON config with blocks (see schema below) using the
Write tool. A typical scratch path is ./_tmp_docx.json.
- 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"
}
]
}
All fields except blocks are optional. Defaults: Arial 11pt, A4, 2 cm margins, tables with grey header and thin grey border. Column widths are in DXA (1440 = 1 inch, 1134 = 2 cm). The table width is the sum of widths.
For image blocks: path is required, width/height are in pixels (if only one is given, the other scales proportionally from the file's natural size; if neither, natural size is used). Supported formats: PNG, JPG, GIF, BMP — type is detected by extension and magic bytes. center aligns the image; before/after set paragraph spacing in twips.
A complete example is in examples/basic.json next to this file.
Dependencies
Must be installed globally on the user's machine (skill assumes they exist):
- Node.js +
npm i -g docx (tested with docx@9.6.1)
- Python 3 with built-in
zipfile
Working rules
- For a new
.docx, always use this skill instead of writing an inline JS-script with docx-js boilerplate from scratch
- For reading an existing
.docx, try read_docx.py first; only escalate to anthropic-skills:docx if you actually need tracked changes / complex formatting
- In Windows paths, use double backslashes inside JSON (
"C:\\Users\\...") or forward slashes
- After creating a
.docx, verify file size with ls -l; a normal document is > 8 KB
По-русски
Облегчённый skill для чтения и создания .docx на Windows с нормальной поддержкой русского. Альтернатива anthropic-skills:docx, когда не нужны tracked changes / find-replace.
Чтение: python <SKILL_DIR>/scripts/read_docx.py file.docx [--tables] - выдаёт plain text с разбивкой по параграфам, опционально рендерит таблицы. UTF-8 stdout всегда (на cp1251 не падает).
Создание: написать JSON-конфиг (схема выше) → node <SKILL_DIR>/scripts/build_docx.js --config spec.json --out result.docx. Автоматически заменяет em-dash и en-dash на обычный дефис, чтобы текст не выглядел сгенерированным ИИ. --keep-dashes отключает.
