mcpField
D
Documents

Documents

github.com/danielmiesslerドキュメント19.6k285 回インストール今日更新
リポジトリ

Documents について

Documentsは、DOCX、PDF、PPTX、XLSXの作成、編集、分析を行うスキルです。専用ワークフローにタスクを振り分け、文書構造の保持と結果の検証を重視します。

主な機能

  1. 014種類の一般的なオフィス形式に対応
  2. 02専用ワークフローへのタスク振り分け
  3. 03変更履歴と形式変換に対応
  4. 04PDFのテキストと表の抽出
  5. 05書式、数式、出力の検証

活用シーン

  1. 01変更履歴付きのWord文書を作成
  2. 02PDFの結合や表の抽出
  3. 03PowerPoint資料の作成と確認
  4. 04Excelデータの分析と数式作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/danielmiessler/lifeos --skill documents

インストール後、Claude Code で/documentsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

Docx/
LICENSE.txt
docx-js.md
ooxml.md
Docx/Ooxml/Scripts/
validate.py
unpack.py
pack.py
Docx/Scripts/
__init__.py
utilities.py
document.py
Pdf/
LICENSE.txt
forms.md
reference.md
Pdf/Scripts/
check_bounding_boxes.py
check_bounding_boxes_test.py
check_fillable_fields.py
convert_pdf_to_images.py
create_validation_image.py
fill_pdf_form_with_annotations.py
extract_form_field_info.py
fill_fillable_fields.py
Pptx/
LICENSE.txt
ooxml.md
Pptx/Ooxml/Scripts/
pack.py
unpack.py
validate.py
Pptx/Scripts/
rearrange.py
thumbnail.py
replace.py
html2pptx.js
Workflows/
ConsultingReport.md

詳細

カスタマイズ

実行する前に、次の場所にユーザーによるカスタマイズがないか確認してください： ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Documents/

このディレクトリが存在する場合は、そこにある PREFERENCES.md、設定、またはリソースを読み込み、適用してください。これらはデフォルトの動作より優先されます。ディレクトリが存在しない場合は、スキルのデフォルト設定で進めてください。

🚨 必須：音声通知（あらゆる操作の前に必須）

このスキルが呼び出されたら、ほかのことをする前に必ずこの通知を送信してください。

  1. 音声通知を送信する：

    curl -s -X POST http://localhost:8888/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Running the WORKFLOWNAME workflow in the Documents skill to ACTION"}' \
  > /dev/null 2>&1 &

  2. テキスト通知を出力する：

    Running the **WorkflowName** workflow in the **Documents** skill to ACTION...

これは任意ではありません。このスキルが呼び出されたら、直ちにこの curl コマンドを実行してください。

Documents スキル

🎯 PAI のコンテキスト全体を読み込む

このスキルでタスクを開始する前に、PAI のコンテキスト全体を読み込んでください：

read ~/.claude/PAI/SKILL.md

このスキルを有効にするタイミング

Word 文書（DOCX）
  • Word 文書の作成、編集、分析を依頼された場合
  • 「変更履歴」、「赤字修正」、「文書レビュー」について言及された場合
  • 文書をほかの形式に変換する必要がある場合
  • 文書の構造、コメント、書式を扱いたい場合
PDF ファイル
  • PDF の作成、結合、分割、加工を依頼された場合
  • 「PDF からテキストを抽出」、「PDF の表」、「PDF フォームへの入力」について言及された場合
  • PDF をほかの形式に変換する必要がある場合
  • 透かしやパスワードを追加する、または画像を抽出したい場合
PowerPoint プレゼンテーション（PPTX）
  • プレゼンテーションの作成または編集を依頼された場合
  • 「スライド」、「プレゼンテーションのテンプレート」、「発表者ノート」について言及された場合
  • プレゼンテーションをほかの形式に変換する必要がある場合
  • スライドのレイアウトやデザイン要素を扱いたい場合
Excel スプレッドシート（XLSX）
  • スプレッドシートの作成または編集を依頼された場合
  • 「数式」、「財務モデル」、「データ分析」について言及された場合
  • Excel の表、グラフ、ピボットテーブルを扱う必要がある場合
  • スプレッドシートをほかの形式に変換する必要がある場合

ワークフローの振り分け

依頼パターン振り分け先
コンサルティングレポート、McKinsey レポート、評価レポート、プロフェッショナルな PDFWorkflows/ConsultingReport.md
大容量 PDF、大きな PDF の処理、Gemini PDFWorkflows/ProcessLargePdfGemini3.md
Word 文書、DOCX、docx の作成、docx の編集、変更履歴、赤字修正Docx/SKILL.md
PDF、PDF の作成、PDF の結合、PDF の分割、PDF からのテキスト抽出、フォームへの入力Pdf/SKILL.md
プレゼンテーション、PPTX、スライド、PowerPoint、発表者ノートPptx/SKILL.md
スプレッドシート、XLSX、Excel、数式、財務モデル、データ分析Xlsx/SKILL.md

文書タイプの詳細

このスキルでは、4 種類の文書と特化したワークフローにわたる文書処理を整理しています。

コンサルティングレポート（HTML + Playwright PDF）

参考ドキュメント：

  • Workflows/ConsultingReport.md - コンサルティングレポート作成ワークフローの全容

振り分けロジック：

  • 「コンサルティングレポートを作成」、「レポート PDF を生成」→ ConsultingReport ワークフロー
  • 「評価レポートを作成」、「戦略的評価」→ ConsultingReport ワークフロー
  • 「McKinsey 風レポート」、「プロフェッショナルなレポート PDF」→ ConsultingReport ワークフロー

パイプライン： レポートの成果物 → 構造化 HTML → Playwright PDF

主な機能：

  • 内容が混在するレポートディレクトリ（Markdown、TypeScript のデータ、画像）を解析
  • プロフェッショナルな CSS タイポグラフィ（本文は Georgia のセリフ体、見出しは Inter のサンセリフ体）
  • 色分けされたコールアウトボックス（赤／琥珀色／緑）と重大度バッジ
  • リンク付き目次を自動生成
  • 分類表示付きの表紙
  • CONFIDENTIAL とページ番号を含むヘッダー／フッター
  • 画像圧縮パイプライン（PNG → JPEG、最大 1200px）
  • Playwright を使用した、ピクセル単位で正確な PDF 出力の A4 形式

参考実装： /path/to/reference/generate-pdf.mjs にある Quorum Cyber の評価レポート

Word 文書（DOCX）

リファレンスドキュメント：

  • docx/SKILL.md - DOCX 処理の完全ガイド
  • docx/docx-js.md - JavaScript で新しい文書を作成する方法
  • docx/ooxml.md - OOXML で既存の文書を編集する方法

ルーティングロジック：

  • 「Word 文書を作成」「新しい docx」→ 作成ワークフロー（docx-js）
  • 「Word 文書を編集」「変更履歴」「赤字修正」→ 編集ワークフロー（OOXML）
  • 「Word 文書を読む」「docx からテキストを抽出」→ 読み取りワークフロー（pandoc）
  • 「文書レビュー」「変更履歴を記録」→ 赤字修正ワークフロー

関連リソース：

  • スクリプト：~/.claude/skills/Utilities/Documents/Docx/Scripts/
  • OOXML ツール：~/.claude/skills/Utilities/Documents/Docx/ooxml/
  • ライセンス：~/.claude/skills/Utilities/Documents/Docx/LICENSE.txt

主な機能：

  • docx-js でプロフェッショナルな文書を作成
  • 変更履歴付きで編集（赤字修正ワークフロー）
  • pandoc でテキストやコメントを抽出
  • 目視確認用に画像へ変換
  • 高度な機能には生の OOXML を使用
PDF 処理

リファレンスドキュメント：

  • pdf/SKILL.md - PDF 処理の完全ガイド
  • pdf/forms.md - PDF フォームへの入力
  • pdf/reference.md - 高度な機能とトラブルシューティング

ルーティングロジック：

  • 「PDF を作成」→ 作成ワークフロー（reportlab）
  • 「PDF を結合」「PDF を分割」→ 操作ワークフロー（pypdf）
  • 「PDF からテキストを抽出」→ 抽出ワークフロー（pdfplumber）
  • 「PDF フォームに入力」→ フォームワークフロー（pdf-lib または pypdf）
  • 「PDF から表を抽出」→ 表抽出（pdfplumber + pandas）

関連リソース：

  • スクリプト：~/.claude/skills/Utilities/Documents/Pdf/Scripts/
  • ライセンス：~/.claude/skills/Utilities/Documents/Pdf/LICENSE.txt

主な機能：

  • reportlab で PDF を作成
  • pdfplumber でテキストや表を抽出
  • pypdf または qpdf で結合・分割
  • プログラムでフォームに入力
  • 透かしとパスワード保護を追加
  • PDF から画像を抽出
PowerPoint プレゼンテーション（PPTX）

リファレンスドキュメント：

  • pptx/SKILL.md - PPTX 処理の完全ガイド
  • pptx/html2pptx.md - HTML からプレゼンテーションを作成
  • pptx/ooxml.md - 既存のプレゼンテーションを編集

ルーティングロジック：

  • 「プレゼンテーションを作成」「新しいスライド」→ 作成ワークフロー（html2pptx）
  • 「プレゼンテーションを編集」「スライドを変更」→ 編集ワークフロー（OOXML）
  • 「プレゼンテーションのテンプレートを使用」→ テンプレートワークフロー
  • 「スライドのテキストを抽出」→ 読み取りワークフロー（markitdown）
  • 「サムネイルのグリッドを作成」→ サムネイルワークフロー

関連リソース：

  • スクリプト：~/.claude/skills/Utilities/Documents/Pptx/Scripts/
  • OOXML ツール：~/.claude/skills/Utilities/Documents/Pptx/ooxml/
  • ライセンス：~/.claude/skills/Utilities/Documents/Pptx/LICENSE.txt

主な機能：

  • html2pptx でプレゼンテーションを作成（HTML → PPTX）
  • カラーパレットとレイアウトを使ったプロフェッショナルなデザイン
  • 高度な機能には OOXML で編集
  • テンプレートを操作（並べ替え、一覧表示、置換）
  • 視覚的な分析用にサムネイルのグリッドを生成
  • 確認用に画像へ変換
Excel スプレッドシート（XLSX）

リファレンスドキュメント：

  • xlsx/SKILL.md - XLSX 処理の完全ガイド
  • xlsx/recalc.py - 数式再計算スクリプト

ルーティングロジック：

  • 「スプレッドシートを作成」「新しい Excel ファイル」→ 作成ワークフロー（openpyxl）
  • 「スプレッドシートを編集」「Excel を変更」→ 編集ワークフロー（openpyxl）
  • 「データを分析」「Excel を読む」→ 分析ワークフロー（pandas）
  • 「財務モデル」「数式」→ 財務モデリングワークフロー
  • 「数式を再計算」→ 再計算ワークフロー（recalc.py）

関連リソース：

  • 再計算スクリプト：~/.claude/skills/Utilities/Documents/Xlsx/recalc.py
  • ライセンス：~/.claude/skills/Utilities/Documents/Xlsx/LICENSE.txt

主な機能：

  • 数式付きスプレッドシートを作成（openpyxl）
  • pandas でデータを分析
  • 色分けの標準に沿った財務モデリング
  • LibreOffice で数式を再計算
  • エラーの検出と検証
  • 編集時に書式と数式を保持

📋 ドキュメント処理の原則

DOCX のベストプラクティス
  1. 変更履歴 - プロフェッショナルな文書レビューには、赤入れのワークフローを使用します
  2. 最小限の編集 - 実際に変更するテキストのみをマークし、元の RSID を保持します
  3. 変更のバッチ処理 - 関連する編集をまとめて（3～10 件）効率的に処理します
  4. 検証 - 変更が正しく適用されたことを確認するため、必ず Markdown に変換します
PDF のベストプラクティス
  1. ライブラリの選定 - 基本操作には pypdf、テキストや表には pdfplumber、作成には reportlab を使用します
  2. スキャン文書の OCR - スキャン文書には pytesseract と pdf2image を使用します
  3. フォームへの入力 - プログラムからフォームに入力する場合は forms.md に従います
  4. コマンドライン - シンプルな操作には qpdf／pdftotext を使用します
PPTX のベストプラクティス
  1. まずデザインを決める - コーディングの前に内容を分析し、適切な色やレイアウトを選びます
  2. ウェブセーフフォント - ウェブセーフフォント（Arial、Helvetica、Times など）のみを使用します
  3. 視覚的な検証 - レイアウトの問題を確認するため、必ずサムネイルを生成します
  4. テンプレートの分析 - テンプレートを使用する前に、構造を把握するための一覧を作成します
XLSX のベストプラクティス
  1. 数式を使用する - 必ず Excel の数式を使用し、計算値を直接入力しないでください
  2. エラーゼロ - 数式エラー（#REF!、#DIV/0! など）がない状態で納品します
  3. 再計算 - 作成または編集後に recalc.py を実行し、数式の値を更新します
  4. 財務上の基準 - 色分け（入力値は青、数式は黒、リンクは緑）に従います

例

例 1：変更履歴を付けて提案書を作成する

User: "Create a consulting proposal doc with redlining"
→ Routes to DOCX workflows
→ Creates document with docx-js
→ Enables tracked changes for review workflow
→ Outputs professional .docx with revision marks

例 2：プログラムから PDF フォームに入力する

User: "Fill out this NDA PDF with my info"
→ Routes to PDF workflows
→ Reads form fields from PDF
→ Fills fields programmatically with pdf-lib
→ Outputs completed, flattened PDF

例 3：財務モデルのスプレッドシートを作成する

User: "Create a revenue projection spreadsheet"
→ Routes to XLSX workflows
→ Creates workbook with openpyxl
→ Adds formulas (never hardcoded values)
→ Runs recalc.py to update calculations

例 4：プロフェッショナルなコンサルティングレポートの PDF を生成する

User: "Create a consulting report from the assessment data"
→ Routes to ConsultingReport workflow
→ Parses report directory for data files, markdown, diagrams
→ Compresses images (PNG→JPEG, max 1200px)
→ Generates styled HTML with professional typography
→ Converts to PDF via Playwright with headers/footers
→ Outputs McKinsey-quality A4 PDF with TOC, diagrams, color boxes

🔗 他のスキルとの連携

活用先：
  • writing スキル - ブログ記事やニュースレター用の文書を作成します
  • business スキル - コンサルティング提案書や財務モデルを作成します
  • research スキル - 調査文書からデータを抽出します
使用するスキル：
  • media スキル - 文書の挿絵用画像を作成します
  • development スキル - 文書処理の自動化を構築します
  • system スキル - コマンドラインツールやスクリプトを使用します

🎯 重要な原則

文書の作成
  1. 品質を最優先 - 最初からプロフェッショナルな書式と構成にします
  2. テンプレートの再利用 - 利用可能な場合は既存のテンプレートを活用します
  3. 検証 - 出力を必ず確認します（目視確認、エラーチェック）
  4. 自動化 - 繰り返し作業にはスクリプトを使用します
文書の編集
  1. 意図を維持 - 元の書式と構成を保ちます
  2. 変更履歴 - 文書レビューには適切なワークフローを使用します
  3. バッチ処理 - 関連する操作をまとめ、効率化します
  4. エラーの防止 - 最終確定前に検証します
文書の分析
  1. 適切なツール - タスクに適したライブラリ／ツールを選びます
  2. データの完全性 - 抽出／変換時に元のデータを保持します
  3. 形式の把握 - 文書の構造（OOXML、PDF の構造など）を理解します
  4. パフォーマンス - 大きな文書には効率的な方法を使用します

📚 詳細なリファレンスドキュメント

Word 文書（DOCX）：

  • メインガイド：~/.claude/skills/Utilities/Documents/Docx/SKILL.md
  • 作成リファレンス：~/.claude/skills/Utilities/Documents/Docx/docx-js.md
  • 編集リファレンス：~/.claude/skills/Utilities/Documents/Docx/ooxml.md

PDF 処理：

  • メインガイド：~/.claude/skills/Utilities/Documents/Pdf/SKILL.md
  • フォームガイド：~/.claude/skills/Utilities/Documents/Pdf/forms.md
  • 詳細リファレンス：~/.claude/skills/Utilities/Documents/Pdf/reference.md

PowerPoint プレゼンテーション（PPTX）：

  • メインガイド：~/.claude/skills/Utilities/Documents/Pptx/SKILL.md
  • 作成リファレンス：~/.claude/skills/Utilities/Documents/Pptx/html2pptx.md
  • 編集リファレンス：~/.claude/skills/Utilities/Documents/Pptx/ooxml.md

Excel スプレッドシート（XLSX）：

  • メインガイド：~/.claude/skills/Utilities/Documents/Xlsx/SKILL.md
  • 再計算スクリプト：~/.claude/skills/Utilities/Documents/Xlsx/recalc.py

概要

documents スキルは、包括的なドキュメント処理を提供します。

  • DOCX - 変更履歴のサポート付きで、Word ドキュメントの作成、編集、分析を行います
  • PDF - フォーム入力機能を備え、PDF の作成、操作、内容の抽出を行います
  • PPTX - プロフェッショナルなデザインとテンプレートを使用して、プレゼンテーションを作成、編集します
  • XLSX - 数式や財務モデリングに対応したスプレッドシートを作成、編集します

リファレンスベースの構成 - 各ドキュメントタイプに、包括的なガイドとツールが用意されています

ルーティングは自動です - ユーザーの意図を分析し、適切なドキュメントタイプのワークフローを有効にします

プロフェッショナルな品質 - 本番環境で使用できるドキュメント向けの標準とベストプラクティスを備えています

コメント

Markdown 対応