Docx CLI
CLI for AI agents (Claude, Codex) to read, edit, and comment on .docx files with full format fidelity.
Install
npx skills add kklimuk/docx-cliclaude mcp add docx-cli -- npx skills add kklimuk/docx-cli{
"mcpServers": {
"docx-cli": {
"command": "npx",
"args": [
"skills",
"add",
"kklimuk/docx-cli"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →docx-cli
Let your AI agent edit Word documents—with tracked changes you can review.
Fill templates, revise contracts, and leave comments in existing .docx files. Open the result in Word to accept or reject the edits. docx-cli edits the document’s XML in place to preserve surrounding formatting and content.
Why choose docx-cli for Word?
In our October 10, 2026 Word-task benchmark, docx-cli scored 18/18 successful attempts (100%) versus OfficeCLI’s 14/18 (77.8%), with 41% fewer tool calls. The Anthropic docx skill also scored 18/18; docx-cli matched that result with 21% fewer tool calls.
| docx-cli 0.27.0 reductions | vs. Anthropic docx skill | vs. OfficeCLI 1.0.156 |
|---|---|---|
| Tool calls | 21% fewer | 41% fewer |
| Effective input tokens¹ | 22% fewer | 53% fewer |
| Output tokens² | 41% fewer | 49% fewer |
| Cumulative task time³ | 27% less | 50% less |
We used the same Haiku 5.5 model for six tasks, each repeated three times per tool: fill an NDA, edit an invoice, restyle a résumé, redline a contract, finalize a review, and author a journal. Reductions are calculated from unrounded averages per six-task run, then rounded to whole percentages.
¹ Cache-weighted input proxy, not dollar cost. ² Includes estimates where final token usage is unavailable. ³ Sum of task durations, not elapsed batch time.
All 54 outputs opened in Microsoft Word. All 18 docx-cli outputs received sound-layout and preserved-formatting judgments. This is our development corpus, and model judges knew which tool produced each output; success does not mean every output was defect-free. Results apply to the exact tested builds.
Absolute measurements, ranges, per-task outcomes, and limitations · Comparison protocol · Earlier benchmarks
Try it with your agent
Install the skill into your agent using skills.sh:
npx skills add kklimuk/docx-cli
Choose your agent in the installer. The skill includes a bootstrap script that installs the standalone docx binary on first use. You need Node/npm for this skill-install command; the standalone binary does not require Bun. Other installation options.
Download the sample NDA into your working folder, then give your agent this prompt:
Use the docx-cli skill to edit mnda.docx. Save a copy as mnda-reviewed.docx and keep the original unchanged. Turn on tracked changes. Replace “having a reasonable need to know” with “with a documented need to know”. Add a comment on the new wording: “Please confirm this narrower access requirement.” Keep the rest of the document unchanged and leave the revisions pending for review.
Open mnda-reviewed.docx in Word and choose Review → All Markup. You should see the wording change and an anchored comment, ready for review.
Full walkthrough and troubleshooting.
Use it from the terminal
Bun package (npm registry) — the simplest path with Bun >= 1.3:
bun add -g bun-docx
# or run without installing:
bunx bun-docx read doc.docx
Similar plugs
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…
Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.
Production-grade engineering skills for AI coding agents.
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…