This Claude skill provides comprehensive capabilities for Word document (.docx) management, enabling automated creation, advanced editing, and structural analysis. It supports professional workflows by allowing users to programmatically generate documents from templates, extract text via Pandoc, and implement precise 'track changes' (redlining) through direct OOXML manipulation, making it an essential tool for high-fidelity document automation.

When should I use docx?

docx is useful in the following scenarios: • Automated Report Generation: Creating professional business reports and invoices by injecting data into pre-defined Word templates. • Legal and Contractual Editing: Programmatically adding track changes, comments, and revisions to legal documents for collaborative review. • Content Migration and Extraction: Converting legacy DOCX files into Markdown or plain text for knowledge base integration while preserving document structure. • Document Comparison and Analysis: Analyzing differences between multiple versions of a document to identify specific textual or formatting changes. • Batch Document Processing: Performing bulk updates or metadata extraction across large sets of Word files for administrative efficiency.

name	docx
description	\|

Word文書（DOCX）処理スキル

Word文書（.docx）の作成、編集、分析機能を提供する。DOCXファイルはXML構造を含むZIPアーカイブである。

依存関係

# コマンドラインツール
brew install pandoc  # macOS
apt-get install pandoc libreoffice  # Ubuntu/Debian

# Pythonライブラリ
pip install defusedxml

# Node.js ライブラリ
npm install docx

主要ワークフロー

1. テキスト読み取り

# Markdownに変換（変更履歴を保持）
pandoc --track-changes=all file.docx -o output.md

2. 新規文書作成

references/docx-js.md を必ず読んでから、docx-jsライブラリを使用する。

import { Document, Paragraph, TextRun, Packer } from 'docx';
import * as fs from 'fs';

const doc = new Document({
    sections: [{
        children: [
            new Paragraph({
                children: [
                    new TextRun({ text: "見出し", bold: true, size: 28 }),
                ],
            }),
            new Paragraph({
                children: [
                    new TextRun("本文テキスト"),
                ],
            }),
        ],
    }],
});

Packer.toBuffer(doc).then((buffer) => {
    fs.writeFileSync("output.docx", buffer);
});

3. 既存文書の編集

references/ooxml.md を必ず読んでから、以下の手順で編集する：

展開: python ${CLAUDE_PLUGIN_ROOT}/skills/docx/ooxml/scripts/unpack.py <file.docx> <dir>
編集: Documentライブラリで word/document.xml を編集
パック: python ${CLAUDE_PLUGIN_ROOT}/skills/docx/ooxml/scripts/pack.py <dir> <output.docx>

4. 変更履歴（Redlining）

変更履歴付きの編集を行う場合、references/ooxml.md のTracked Changes実装セクションを参照。

重要なルール:

変更されるテキストのみをマーク
変更されない <w:r> 要素は保持
関連する変更を3〜10個のバッチにグループ化
編集前に document.xml を grep で確認

クリティカルな原則

最小限の編集: 実際に変更されるテキストのみをマークする
バッチ戦略: 関連する変更をセクション、タイプ、または位置でグループ化
検証: スクリプト作成前に document.xml を grep、実装後に全変更を検証

詳細リファレンス

JavaScript docxライブラリ: references/docx-js.md
Office Open XML技術仕様: references/ooxml.md

クイックリファレンス

操作	ツール/方法
テキスト抽出	`pandoc`
新規作成	`docx` (npm)
既存編集	OOXML + Documentライブラリ
変更履歴	Documentライブラリ
検証	`validate.py`

スクリプト一覧

スクリプト	説明
`ooxml/scripts/unpack.py`	DOCXをディレクトリに展開
`ooxml/scripts/pack.py`	ディレクトリをDOCXにパック
`ooxml/scripts/validate.py`	XSDスキーマと変更履歴を検証
`scripts/utilities.py`	XML編集ユーティリティ
`scripts/document.py`	変更履歴・コメント管理

docx

When & Why to Use This Skill

Use Cases