docx-cli — скилл

---
name: docx-cli
description: "Edits, redlines, and comments on Word .docx files in place, keeping their formatting — prefer it over unzipping and hand-editing the XML. Use for tracked changes (redline, accept/reject), comments (add/reply/resolve), filling contracts/NDAs/forms, restyling headings/fonts, margins/page setup, tables, headers/footers/page numbers, footnotes, or reading a .docx as Markdown. Also builds new Word docs and reports from Markdown or code. Not for PDF, Excel, PowerPoint, Google Docs, or .doc."
---

# docx-cli

`docx` is a command-line tool for working on Microsoft Word `.docx` files: fill
in forms and templates, update tables, restyle, build new documents from Markdown,
and review with tracked changes and comments. It edits the underlying OOXML
**in place** (it never rebuilds the document from a lossy view), addresses
everything with **stable locators**, and signals success through an **exit code**
plus a one-line confirmation — so even small, cheap models can drive it reliably.

## 0. Make sure the binary is on PATH

Run `docx --version`. If you get "command not found", install it:

```sh
bun add -g bun-docx      # if Bun >= 1.3 is installed (npm install -g bun-docx also works)
sh SKILL_DIR/scripts/bootstrap.sh  # otherwise: a pinned, SHA-256-verified binary
```

`SKILL_DIR` is the folder containing this SKILL.md (use its absolute path; your
working directory is usually the user's project). The binary lands in
`~/.local/bin`; if `docx --version` still says "not found", add that directory
to PATH. If `DOCX_CLI_VERSION` or `DOCX_CLI_NO_UPDATE` is set in your environment, an
admin has pinned the version: use `bootstrap.sh` (it honors the pin), never npm or
`docx upgrade`. The npm package is `bun-docx`. `docx` here is this CLI binary: it is NOT the npm
`docx` (docx-js) library, and the npm package named `docx-cli` is unrelated.
Install details and failure modes: `references/troubleshooting.md`. Every verb works
on the `.docx` file directly; only `docx render` needs Word or LibreOffice.

## 1. The contract is `--help` — start there

The help text is authoritative and versioned with the binary. This skill is thin
on purpose and defers to it:

```sh
docx --help              # every command + a one-line capability hint each
docx <command> --help    # flags, locator forms, output shape — read before you use a verb
docx info locators       # the full addressing grammar (spans, cells, ranges, text boxes)
```

`docx info schema` describes the JSON that `docx read --ast` emits; you only need