DOCX Diff for Openclaw

A local utility for comparing Word documents to track text additions, deletions, image updates, and formatting changes.

mypicko
v1.0.0
May 3, 2026
0
657
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install docx-diff

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install docx-diff using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is DOCX Diff?

DOCX Diff is a robust tool within the Openclaw Skills ecosystem designed for users who need precise document versioning without relying on cloud services. By analyzing the underlying XML structure of .docx files, it identifies changes in paragraphs, tables, and media. This Openclaw Skills utility is particularly useful for tracking revisions in technical specs, legal documents, and project reports where privacy and accuracy are paramount, providing a secure way to visualize exactly what has changed between two versions.

DOCX Diff Use Cases

  • Tracking revisions in legal contracts or technical documentation.
  • Auditing image or diagram updates within complex reports.
  • Identifying style and formatting changes to maintain document consistency.
  • Generating automated diff reports for version-controlled document workflows.
  • Comparing data integrity within Word tables.

How DOCX Diff Works

  1. Verify the python-docx dependency is installed on the local system.
  2. Identify the script location within the Openclaw Skills directory structure based on the operating system.
  3. Execute the Python script by providing paths for the baseline (old) and target (new) documents.
  4. Analyze text via similarity thresholds and verify image integrity using MD5 hashing.
  5. Export comprehensive results into three distinct formats: an interactive HTML dashboard, a highlighted Word document, and a text summary.

DOCX Diff Setup

First, ensure the necessary dependencies are installed:

pip install python-docx

To run a comparison, use the script located in your local Openclaw Skills folder:

# Example for Windows
python "%USERPROFILE%\.openclaw\skills\docx-diff\scripts\compare_docx.py" --file1 "v1.docx" --file2 "v2.docx"

# Example for macOS/Linux
python ~/.openclaw/skills/docx-diff/scripts/compare_docx.py --file1 "v1.docx" --file2 "v2.docx"

DOCX Diff Data Schema & Taxonomy

The skill organizes its output into a structured set of files for different review requirements:

File Type Description
*_diff.html An interactive report viewable in any browser, supporting filtering by change type.
*_diff.docx A standard Word document where Red indicates deletions and Green indicates additions.
*_diff.txt A plain text report containing a summary of all detected modifications.
Metadata Uses MD5 hashing for images to ensure content changes are detected even if filenames are identical.

DOCX Diff Advanced Features

  • Adjustable similarity thresholds (0.0 to 1.0) to fine-tune how aggressively the tool identifies paragraph modifications versus new additions.
  • Targeted comparison modes including all, text only, or image only to reduce noise in complex files.
  • Full support for table content scanning, ensuring no data change is overlooked in grids.
  • Style detection that identifies font and formatting variations even when the text content is unchanged.
  • Self-contained HTML reports with embedded images, making it easy to share comparison results as a single file.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*