SkillAgentSearch skills...

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-toolkit

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Category

Automation

Supported Platforms

Universal

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.

Substance
26/30
Structure
18/20
Description
12/15
Adoption
12/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
docx-toolkit (this skill)by borghei8381757d agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.9k8d agoCLAUDE.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.

name: 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:

  1. Run: python scripts/docx_auditor.py document.docx
  2. 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
  3. 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:

  1. Run audit on the returned .docx
  2. Comment count > 20 or tracked-change paragraphs > 30% → expect a heavy review pass; schedule time
  3. Comment count < 5 → likely cosmetic; quick turnaround possible
  4. Use references/docx_review_checklist.md for 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:

  1. Define allowed styles in your style guide (see assets/style_compliance_template.md)
  2. Run audit on candidate documents
  3. Flag any document using styles outside the allowed set
  4. 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 styles
  • assets/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-builder for board-pack documents

Related Skills

View on GitHub
GitHub Stars817
CategoryAutomation
Updated1mo ago
Forks141

Languages

HTML

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium