How do I install the Word DOCX Splitter skill?

Run npx skillmds@latest add diegosouzapw/word-docx-splitter in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Word DOCX Splitter safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Word DOCX Splitter?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Word DOCX Splitter free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Word DOCX Splitter?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Word DOCX Splitter by diegosouzapw — Agent Skill

Name: Word DOCX Splitter
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

Word DOCX Splitter

Split large Word documents (.docx) into smaller chunks and reassemble them. Use when working with large legal documents, contracts, or agreements that need to be processed in smaller pieces—particularly useful when AI tools struggle with document size limits. Supports splitting by heading style (e.g., "Heading 1") or text pattern (e.g., "ARTICLE"), and merging edited chunks back together.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Word Document Splitter & Merger

Split large .docx files into smaller documents by article/section, then reassemble after editing.

Dependencies

pip install python-docx lxml --break-system-packages

Quick Reference

Task	Command
List styles	`python scripts/docx_splitter.py doc.docx --list-styles`
Split by style	`python scripts/docx_splitter.py doc.docx --split-on "Heading 1"`
Split by pattern	`python scripts/docx_splitter.py doc.docx --pattern "ARTICLE"`
Merge chunks	`python scripts/docx_merger.py ./chunks/ -o merged.docx`

Splitting Documents

Step 1: Identify Split Points

Always check available styles first:

python scripts/docx_splitter.py document.docx --list-styles

Step 2: Split

By heading style (preferred for well-formatted documents):

python scripts/docx_splitter.py document.docx --split-on "Heading 1" --output-dir ./chunks

By text pattern (for inconsistent styling):

python scripts/docx_splitter.py document.docx --pattern "ARTICLE" --output-dir ./chunks
python scripts/docx_splitter.py document.docx --pattern "^SECTION \d+" --output-dir ./chunks

Split Options

Option	Description
`--split-on`, `-s`	Style name (e.g., "Heading 1", "Heading 2")
`--pattern`, `-p`	Regex pattern (e.g., "ARTICLE", "^SECTION \d+")
`--output-dir`, `-o`	Output directory (default: `<input>_split/`)
`--no-header`	Exclude preamble content from each chunk

Output Structure

Files are numbered for proper ordering:

document_split/
├── 00_Preamble.docx          # Content before first split point
├── 01_ARTICLE_I.docx
├── 02_ARTICLE_II.docx
└── ...

Merging Documents

Reassemble edited chunks:

python scripts/docx_merger.py ./chunks/ -o final_document.docx

Merge specific files in order:

python scripts/docx_merger.py file1.docx file2.docx file3.docx -o merged.docx

Merge Options

Option	Description
`-o`, `--output`	Output path (required)
`--page-breaks`	Add page breaks between sections
`--include-duplicates`	Keep duplicate preamble content

Typical Workflow

# 1. Check document structure
python scripts/docx_splitter.py BigContract.docx --list-styles

# 2. Split by articles
python scripts/docx_splitter.py BigContract.docx --split-on "Heading 1" -o ./chunks

# 3. Edit individual chunks (with Harvey, Claude, or manually)

# 4. Reassemble
python scripts/docx_merger.py ./chunks/ -o BigContract_Final.docx

Limitations

Cross-references: Internal references preserved but not auto-updated if sections renumber
Tables: Tables spanning split boundaries may break
Numbering: Automatic numbering restarts per chunk
Track changes: Preserved but may need reconciliation after merge

Tips for Legal Documents

Split at ARTICLE level for credit agreements and loan documents
Use --pattern when heading styles are inconsistent (common in opposing counsel docs)
For very large definition sections, re-split that chunk by "Heading 2"
Review merged document at section boundaries for formatting issues

---name: word-docx-splitterdescription: Split large Word documents (.docx) into smaller chunks and reassemble them. Use when working with large legal documents, contracts, or agreements that need to be processed in smaller pieces—particularly useful when AI tools struggle with document size limits. Supports splitting by heading style (e.g., "Heading 1") or text pattern (e.g., "ARTICLE"), and merging edited chunks back together.---# Word Document Splitter & MergerSplit large .docx files into smaller documents by article/section, then reassemble after editing.## Dependencies```bashpip install python-docx lxml --break-system-packages```## Quick Reference| Task | Command ||------|---------|| List styles | `python scripts/docx_splitter.py doc.docx --list-styles` || Split by style | `python scripts/docx_splitter.py doc.docx --split-on "Heading 1"` || Split by pattern | `python scripts/docx_splitter.py doc.docx --pattern "ARTICLE"` || Merge chunks | `python scripts/docx_merger.py ./chunks/ -o merged.docx` |## Splitting Documents### Step 1: Identify Split PointsAlways check available styles first:```bashpython scripts/docx_splitter.py document.docx --list-styles```### Step 2: Split**By heading style** (preferred for well-formatted documents):```bashpython scripts/docx_splitter.py document.docx --split-on "Heading 1" --output-dir ./chunks```**By text pattern** (for inconsistent styling):```bashpython scripts/docx_splitter.py document.docx --pattern "ARTICLE" --output-dir ./chunkspython scripts/docx_splitter.py document.docx --pattern "^SECTION \d+" --output-dir ./chunks```### Split Options| Option | Description ||--------|-------------|| `--split-on`, `-s` | Style name (e.g., "Heading 1", "Heading 2") || `--pattern`, `-p` | Regex pattern (e.g., "ARTICLE", "^SECTION \d+") || `--output-dir`, `-o` | Output directory (default: `<input>_split/`) || `--no-header` | Exclude preamble content from each chunk |### Output StructureFiles are numbered for proper ordering:```document_split/├── 00_Preamble.docx # Content before first split point├── 01_ARTICLE_I.docx├── 02_ARTICLE_II.docx└── ...```## Merging DocumentsReassemble edited chunks:```bashpython scripts/docx_merger.py ./chunks/ -o final_document.docx```**Merge specific files in order:**```bashpython scripts/docx_merger.py file1.docx file2.docx file3.docx -o merged.docx```### Merge Options| Option | Description ||--------|-------------|| `-o`, `--output` | Output path (required) || `--page-breaks` | Add page breaks between sections || `--include-duplicates` | Keep duplicate preamble content |## Typical Workflow```bash# 1. Check document structurepython scripts/docx_splitter.py BigContract.docx --list-styles# 2. Split by articlespython scripts/docx_splitter.py BigContract.docx --split-on "Heading 1" -o ./chunks# 3. Edit individual chunks (with Harvey, Claude, or manually)# 4. Reassemblepython scripts/docx_merger.py ./chunks/ -o BigContract_Final.docx```## Limitations- **Cross-references**: Internal references preserved but not auto-updated if sections renumber- **Tables**: Tables spanning split boundaries may break- **Numbering**: Automatic numbering restarts per chunk- **Track changes**: Preserved but may need reconciliation after merge## Tips for Legal Documents- Split at ARTICLE level for credit agreements and loan documents- Use `--pattern` when heading styles are inconsistent (common in opposing counsel docs)- For very large definition sections, re-split that chunk by "Heading 2"- Review merged document at section boundaries for formatting issues

Frequently asked questions