docx-toolkit
Audit Microsoft Word (.docx) documents for heading hierarchy, comments, tracked changes, and style consistency
Install / Use
npx skills add borghei/Claude-Skills --skill docx-toolkitInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of docx-toolkit
docx-toolkit scores 83/100 on our quality scale, 2227th of 2,769 Automation skills we index.
Its SKILL.md is 5.0 KB long, well organised into 17 sections with 2 code examples: a solid amount of guidance for an agent.
It has 817 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so docx-toolkit is actively maintained.
- Our last check on 2026-11-07 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
docx-toolkit compared with similar skills
All 4 of these similar skills score higher than docx-toolkit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| docx-toolkit (this skill)by borghei | 83 | 817 | 57d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.9k | 8d ago | CLAUDE.md |
Frequently asked questions
- How do I install docx-toolkit?
- Run
npx skills add borghei/Claude-Skills --skill docx-toolkit. The install tabs above show the steps for each supported agent. - Which AI agents does docx-toolkit work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is docx-toolkit safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is docx-toolkit still maintained?
- The repository was last updated about 2 months ago, so docx-toolkit is actively maintained.
Skill content
View source on GitHubname: docx-toolkit description: > Audit Microsoft Word (.docx) documents for heading hierarchy, comments, tracked changes, broken cross-references, and style consistency. Use when reviewing a contract draft, preparing a document for handoff, or enforcing a style guide. license: MIT + Commons Clause metadata: version: 1.0.0 author: borghei category: documents domain: document-automation updated: 2026-05-04 python-tools: docx_auditor.py tech-stack: docx, OOXML
Docx Toolkit
Audit .docx files using the standard library only — no python-docx required. Reads OOXML directly with zipfile + xml.etree.
Table of Contents
Keywords
docx, Word, Microsoft Word, document, document review, comments, tracked changes, redline, headings, style guide, word count, document audit
Clarify First
Before running the audit, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- [ ] Audit purpose (pre-handoff cleanup, contract-review triage, or style-guide enforcement) — selects the workflow and the thresholds you apply
- [ ] Recipient (external customer, opposing counsel, internal) — sets the tolerance for leftover comments and tracked changes
- [ ] Allowed style set (for style-guide enforcement) — defines what counts as a non-conforming style
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
python scripts/docx_auditor.py contract.docx
Outputs: word count, paragraph count, heading hierarchy, comment count, tracked-changes status, hyperlink count, list of unique paragraph styles used.
Core Workflows
Workflow 1: Pre-Handoff Document Audit
Goal: Catch the issues that embarrass a sender — leftover comments, unresolved track changes, broken heading hierarchy — before the document leaves.
Steps:
- Run:
python scripts/docx_auditor.py document.docx - Review the audit output:
- Comment count > 0 → resolve or remove before sending
- Tracked changes detected → accept or reject before sending
- Heading-hierarchy gaps (H1 → H3 with no H2) → restructure
- Style sprawl (more than 8 paragraph styles) → consolidate
- Re-run until clean
Time Estimate: 5-15 minutes per document.
Workflow 2: Contract Review Triage
Goal: Quantify how much rework a returned contract needs before reading it line-by-line.
Steps:
- Run audit on the returned
.docx - Comment count > 20 or tracked-change paragraphs > 30% → expect a heavy review pass; schedule time
- Comment count < 5 → likely cosmetic; quick turnaround possible
- Use
references/docx_review_checklist.mdfor the actual content review
Time Estimate: 1 minute per document for triage.
Workflow 3: Style-Guide Enforcement
Goal: Detect documents drifting from your style guide before they ship to a customer.
Steps:
- Define allowed styles in your style guide (see
assets/style_compliance_template.md) - Run audit on candidate documents
- Flag any document using styles outside the allowed set
- Map non-conforming paragraphs back to standard styles
Time Estimate: 2-5 minutes per document.
Tools
docx_auditor.py
Reads a .docx file as a ZIP archive and parses OOXML directly. No external dependencies.
# Human-readable
python scripts/docx_auditor.py document.docx
# JSON
python scripts/docx_auditor.py document.docx --json
Reports:
- Word and paragraph counts
- Heading hierarchy (with gap detection)
- Number of comments
- Whether tracked changes are present
- Unique paragraph styles used
- Hyperlink count
- Image count
- Table count
Limits: This tool reads existing docx files. For generating docx, use the templates in assets/ and edit in Word, or install python-docx separately.
Reference Guides
references/docx_review_checklist.md— Pre-handoff checklist; common rework triggers; mistakes that survive automated audits
Templates
assets/style_compliance_template.md— Format for declaring allowed paragraph stylesassets/handoff_checklist_template.md— Pre-send checklist with sign-off boxes
Best Practices
- Audit before every external send. A 30-second audit catches 80% of avoidable embarrassment.
- Resolve comments before "Final v3.docx". Files named "final" with active comments are how lawyers get tickled.
- Lock heading hierarchy. H1 → H3 with no H2 breaks navigation, accessibility, and table-of-contents generation.
- Prefer styles over inline formatting. A style change in one place beats hundreds of inline overrides.
Integration Points
- Pairs with
legal/skills for contract redlines - Pairs with
marketing/copywriting/for content review - Used by
c-level-advisor/board-deck-builderfor board-pack documents
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.9kTurn Claude Code into a full game dev studio — 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
