本文へ移動
cccskills
無料GitHub で公開

docling-converter

docling CLIを使用したドキュメント変換スキル。PDF、DOCX、PPTX、HTML、画像、Excel等のあらゆるドキュメントをMarkdown、JSON、YAML、HTML、テキストに変換。OCR対応で画像内テキストも抽出可能。

Use when converting documents to Markdown or other formats, extracting text from PDFs, processing scanned documents with OCR, or converting office documents. Argument hint: [file_path] [--to md|json|yaml|html|text] [--ocr-lang ja] [--output output_dir]

インストール方法を見る

含まれるファイル(4)

  • SKILL.md10.9 KB
  • assets/.gitkeep0 B
  • references/docling_options.md7.4 KB
  • scripts/.gitkeep0 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Docling Converter

Slash Command Usage

/docling-converter <ファイルパス> [オプション]

Examples

# 基本(Markdownに変換)
/docling-converter document.pdf

# JSON形式で出力
/docling-converter document.pdf --to json

# 日本語OCR付き
/docling-converter scanned.pdf --ocr-lang ja

# 出力先指定
/docling-converter document.pdf --output ./converted/

# 複合オプション
/docling-converter report.pdf --to json --ocr-lang ja --output ./output/

Workflow

  1. 入力確認: ユーザーからファイルパスとオプションを受け取る
  2. 引数解析: ファイルパスとオプション(--to, --ocr-lang, --output等)を解析
  3. デフォルト設定: --to が未指定の場合は md(Markdown)を使用
  4. docling実行: 解析した引数でコマンドを実行
    docling $ARGUMENTS
    
  5. 結果報告: 変換完了後、出力ファイルのパスをユーザーに報告

Output

このスキルは ファイル生成型 です。docling CLIを実行し、変換されたファイル(Markdown、JSON、YAML、HTML、テキスト等)を指定ディレクトリに出力します。

  • デフォルト出力: 入力ファイルと同じディレクトリに .md ファイルを生成
  • カスタム出力: --output オプションで出力先を指定可能
  • 複数形式: --to を複数指定して複数形式を同時生成可能

Overview

doclingは、あらゆるドキュメント形式をMarkdown、JSON、YAML等に変換するための強力なCLIツールです。PDFのテキスト抽出、スキャンドキュメントのOCR、テーブル構造の認識、音声/動画の文字起こしなど、多様なドキュメント処理に対応しています。

When to Use This Skill

このスキルを使用するタイミング:

  • PDFをMarkdownやJSONに変換したい
  • スキャンされたPDFからテキストを抽出したい(OCR)
  • Word、PowerPoint、Excelドキュメントを変換したい
  • 画像からテキストを抽出したい
  • 複数のドキュメントを一括変換したい
  • URLからドキュメントを取得して変換したい
  • 会議の音声/動画を文字起こししたい

Example triggers:

  • "このPDFをMarkdownに変換して"
  • "PDFからテキストを抽出して"
  • "このスキャンしたドキュメントをOCRで読み取って"
  • "WordファイルをJSONに変換して"
  • "このフォルダ内のPDFを全部Markdownに変換して"

Prerequisites

Installation Check

# doclingがインストールされているか確認
docling --version

# インストールされていない場合
python3.12 -m pip install --user --break-system-packages docling

# PATHに追加(.zshrcに追記)
echo 'export PATH="$HOME/Library/Python/3.12/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Quick Start

Basic Conversion

# PDF → Markdown(デフォルト)
docling document.pdf

# 出力先を指定
docling document.pdf --output ./output/

# 出力形式を指定
docling document.pdf --to json
docling document.pdf --to yaml
docling document.pdf --to html
docling document.pdf --to text

Supported Formats

Input Formats (--from)

FormatExtensionDescription
pdf.pdfPDFドキュメント
docx.docxMicrosoft Word
pptx.pptxMicrosoft PowerPoint
xlsx.xlsxMicrosoft Excel
html.htmlWebページ
image.png, .jpg, .tiff画像ファイル
md.mdMarkdown
csv.csvCSVファイル
asciidoc.adocAsciiDoc
audio.mp3, .wav, .m4a音声ファイル
vtt.vttWebVTT字幕

Output Formats (--to)

FormatDescription
mdMarkdown(デフォルト)
jsonJSON形式(構造化データ)
yamlYAML形式
htmlHTMLページ
html_split_pageページ分割HTML
textプレーンテキスト
doctagsドキュメントタグ形式

Core Commands

1. Basic Conversion

# PDF → Markdown
docling document.pdf

# 特定の出力形式
docling document.pdf --to json --output ./output/

# 複数の出力形式を同時に生成
docling document.pdf --to md --to json --output ./output/

2. OCR Processing

# OCR有効(デフォルト)
docling scanned.pdf

# OCR無効化
docling document.pdf --no-ocr

# 強制OCR(既存テキストを上書き)
docling document.pdf --force-ocr

# OCRエンジンを指定
docling document.pdf --ocr-engine ocrmac    # macOS最適化
docling document.pdf --ocr-engine rapidocr  # 高速
docling document.pdf --ocr-engine tesseract # 多言語対応

# OCR言語を指定
docling document.pdf --ocr-lang ja          # 日本語
docling document.pdf --ocr-lang en,ja       # 英語+日本語

3. Table Extraction

# テーブル抽出(デフォルト有効)
docling table-document.pdf

# テーブル抽出無効化
docling document.pdf --no-tables

# テーブルモード(精度優先)
docling document.pdf --table-mode accurate

# テーブルモード(速度優先)
docling document.pdf --table-mode fast

4. Batch Conversion

# ディレクトリ内の全ドキュメントを変換
docling ./documents/ --output ./converted/

# 特定形式のみ変換
docling ./documents/ --from pdf --output ./converted/

5. URL Conversion

# URLからドキュメントを取得して変換
docling https://example.com/document.pdf

# カスタムヘッダー付き
docling https://example.com/document.pdf --headers '{"Authorization": "Bearer token"}'

6. Password-Protected PDF

docling protected.pdf --pdf-password "secret123"

7. Audio/Video Transcription

# 音声/動画の文字起こし
docling meeting.mp4 --pipeline asr

# Whisperモデルを指定
docling meeting.mp4 --pipeline asr --asr-model whisper_medium

# macOS最適化(MLXバックエンド)
docling meeting.mp4 --pipeline asr --asr-model whisper_medium_mlx

Advanced Options

Pipeline Selection

PipelineUse Case
standard通常のドキュメント変換(デフォルト)
vlm画像認識モデルによる高精度変換
asr音声/動画の文字起こし
legacy旧バージョン互換
# VLMパイプライン(画像が多いドキュメント)
docling image-heavy.pdf --pipeline vlm

# ASRパイプライン(音声/動画)
docling meeting.mp4 --pipeline asr

Image Export Mode

# 画像を埋め込み(デフォルト)
docling document.pdf --image-export-mode embedded

# 画像を別ファイルとして参照
docling document.pdf --image-export-mode referenced

# 画像位置のみマーク(プレースホルダー)
docling document.pdf --image-export-mode placeholder

Performance Options

# スレッド数を指定
docling document.pdf --num-threads 8

# デバイスを指定
docling document.pdf --device auto  # 自動選択
docling document.pdf --device cpu   # CPU使用
docling document.pdf --device mps   # Apple Silicon GPU

# タイムアウト設定(秒)
docling large-document.pdf --document-timeout 300

# ページバッチサイズ
docling document.pdf --page-batch-size 8

Debug Options

# 詳細ログ
docling document.pdf -v      # info
docling document.pdf -vv     # debug

# レイアウト可視化
docling document.pdf --show-layout

# デバッグ出力
docling document.pdf --debug-visualize-cells
docling document.pdf --debug-visualize-ocr
docling document.pdf --debug-visualize-layout
docling document.pdf --debug-visualize-tables

Common Patterns

Pattern 1: PDF to Markdown with Japanese OCR

docling japanese-document.pdf \
  --ocr-engine ocrmac \
  --ocr-lang ja \
  --output ./output/

Pattern 2: Batch Convert All PDFs to JSON

docling ./pdfs/ \
  --from pdf \
  --to json \
  --output ./converted/ \
  --num-threads 4

Pattern 3: High-Quality Table Extraction

docling financial-report.pdf \
  --table-mode accurate \
  --to json \
  --output ./output/

Pattern 4: Meeting Recording Transcription

docling meeting-recording.mp4 \
  --pipeline asr \
  --asr-model whisper_medium_mlx \
  --output ./transcripts/

Pattern 5: Scanned Document OCR

docling scanned-contract.pdf \
  --force-ocr \
  --ocr-engine ocrmac \
  --ocr-lang en,ja \
  --output ./extracted/

Pattern 6: URL Document Conversion

docling https://arxiv.org/pdf/xxxx.xxxxx.pdf \
  --to md \
  --output ./papers/

Troubleshooting

Issue: OCR not working

Solution:

# OCRエンジンを確認
docling --help | grep ocr-engine

# macOSの場合、ocrmacが最適
docling document.pdf --ocr-engine ocrmac

Issue: Table extraction inaccurate

Solution:

# 精度優先モードを使用
docling document.pdf --table-mode accurate

# VLMパイプラインを試す
docling document.pdf --pipeline vlm

Issue: Processing timeout

Solution:

# タイムアウトを延長
docling large-document.pdf --document-timeout 600

# ページバッチサイズを小さく
docling document.pdf --page-batch-size 2

Issue: Out of memory

Solution:

# CPUを使用
docling document.pdf --device cpu

# スレッド数を減らす
docling document.pdf --num-threads 2

Issue: Japanese text garbled

Solution:

# 日本語OCRを明示的に指定
docling document.pdf --ocr-lang ja --force-ocr

Resources

Official Documentation

References

詳細なオプションリファレンスは references/docling_options.md を参照してください。

Tips

  1. macOSユーザー: --ocr-engine ocrmac で最高のOCR性能を得られます
  2. 大量ドキュメント: --num-threads でCPUコア数に応じて並列処理
  3. メモリ節約: --device cpu と --page-batch-size 2 を組み合わせ
  4. 日本語ドキュメント: --ocr-lang ja を必ず指定
  5. 構造化データ: テーブルが多いドキュメントは --to json が便利
  6. 会議録: --pipeline asr --asr-model whisper_medium_mlx がmacOSで高速

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

action-status-updater

無料日本語概要

Track and update action item status from natural language updates like 'Seanのメールには返信しておいた' or 'Lu対応予定'. Integrates with daily-comms-ops workflow. Use when managing action items across communication channels.

takusaotome/claude-skills-library92026年10月5日 更新

ai-adoption-consultant

無料日本語概要

AI活用提案の専門コンサルタントスキル。LLM・AIエージェントの活用事例知識を基に、業界別、部門別、シーン別に最適なAI導入提案を行います。システム化、業務改善、効率化を得意とし、具体的な活用事例、期待効果、導入ステップを含む実践的な提案を提供します。Use when proposing AI/LLM adoption strategies for specific industries, departments, or business scenarios.

takusaotome/claude-skills-library92026年10月5日 更新

Generate AI-powered BPO service proposals for Japanese companies in the US market. Use when creating outsourcing proposals with AI service menus, ROI estimation, implementation roadmaps, and bilingual (JA/EN) proposal documents for 在米日系企業向けAI実装.

日本語の概要は準備中です。原文の説明を表示しています。

takusaotome/claude-skills-library92026年10月5日 更新

ai-text-humanizer

無料日本語概要

AI(LLM)が生成した日本語テキストの「AI臭」を検出・診断し、人間らしい文章にリライトするスキル。 Use when: 「AIっぽい文章を直して」「人間らしくリライトして」「AI臭を消して」「この文章をもっと自然にして」 「テキストのAI感を減らして」「機械っぽさを取りたい」 "make this sound more human", "remove AI tone", "humanize this text", "detect if this is AI-generated". 6つのAI特有パターン(視覚的マーカー、単調なリズム、マニュアル的構成、非コミット姿勢、抽象語の濫用、 定型メタファー)を正規表現ベースで検出し、0-100のAI臭スコアを算出。3つの人間化技法 (バランスを崩す・客観を崩す・論理を崩す)でリライトを実行する。 Note: 検出スクリプトは日本語テキスト専用。英語テキストの場合はClaude自身がreferences/を参照して分析・リライトする。

takusaotome/claude-skills-library92026年10月5日 更新

Generate audit-ready internal control design documents from As-Is business process inventories. Produces control IDs, assertion mappings, procedures, SoD analysis, KPIs, materiality thresholds, and implementation roadmaps. Use when building internal controls for new audit engagements, SOX/J-SOX compliance, or process improvement initiatives.

日本語の概要は準備中です。原文の説明を表示しています。

takusaotome/claude-skills-library92026年10月5日 更新

Review audit-related documents (control design documents, bottleneck analyses, requirements definitions, etc.) for quality, scoring them 0-100 with a severity-rated findings list. Use when reviewing audit documents, checking control design quality, or verifying cross-document consistency. Supports documents governed by US GAAP, IFRS, or J-GAAP.

日本語の概要は準備中です。原文の説明を表示しています。

takusaotome/claude-skills-library92026年10月5日 更新

takusaotome のスキルをすべて見る

このスキルの問題を報告する