OCR化した書籍からClaude Codeスキルを自動生成するスラッシュコマンドを作成

結論

2つのスラッシュコマンドを作成した。

1. /book-to-skill - OCR化した書籍からスキルを自動生成
2. /review-book-to-skill - 生成したスキルをレビュー・改善

背景

書籍を裁断してOCR化すると、ページごとのマークダウンファイルが得られる。この書籍に含まれる知識・ルール・ベストプラクティスを、Claude Codeのスキルとして活用したい。

全体フロー

flowchart TD
    A["紙の書籍"] --> B["裁断・スキャン"]
    C["Kindle書籍"] --> D["PDF化"]
    B --> E["Yomitoku OCR"]
    D --> E
    E --> F["マークダウン + 画像"]
    F --> G["#47;book-to-skill"]
    G --> H["スキル自動生成"]
    H --> I["#47;review-book-to-skill"]
    I --> J["Claude Codeスキル完成"]

既存の例として、本多勝一著「日本語の作文技術」から作成した honda-sakubun スキルがある。このスキルは日本語文章の校閲に使用している。

同様の流れを他の書籍にも適用できるよう、汎用的なスラッシュコマンドを作成した。

/book-to-skill コマンド

使い方

/book-to-skill C:/Users/numbe/Books/some-book/

入力は書籍フォルダパスのみ。スキル名・説明はAIが書籍内容から自動決定する。

入力フォルダ構造

book-folder/
├── page_001.md      # OCR変換されたテキスト
├── page_002.md
├── ...
└── images/          # 対応するページ画像（オプション）
    ├── page_001.png
    ├── page_002.png
    └── ...

• マークダウンと画像はファイル名で対応付け（page_001.md ↔ images/page_001.png）
• images/ ディレクトリがない場合はテキストのみで処理

処理フロー

出力構造

.claude/skills/{skill-name}/
├── SKILL.md              # インデックス（概要・使い方・クイックリファレンス）
└── references/           # 章ごとの詳細ドキュメント
    ├── chapter-01.md
    └── ...

注意事項

• 著作権配慮: 書籍の文章をそのまま転載せず、ルール・原則を抽象化・言い換えて使用
• 汎用性の確保: 書籍固有の表現を一般的な形に変換
• 章の統合: 内容が薄い章や重複する章は統合可
• 画像参照の効率化: 全ページの画像を見るのではなく、図表への言及があるページのみ画像を参照（トークン節約）

/review-book-to-skill コマンド

生成したスキルを別のClaude Codeセッションでレビューするためのコマンド。

使い方

/review-book-to-skill investment-basics

レビュー観点

1. 構造の完全性 - ファイル構成、リンク、frontmatter
2. 内容の品質 - 抽象化、DO/DON'T、例、根拠の明確さ
3. 実用性 - トリガー表現、クイックリファレンス、作業手順
4. 冗長性・重複 - 統合すべき章がないか
5. 欠落 - 重要な内容が漏れていないか

レビュー結果を報告後、修正を実施するか確認し、承認されたら修正を行う。

作成したファイル

• .claude/commands/book-to-skill.md
• .claude/commands/review-book-to-skill.md

参考: honda-sakubunスキルの構造

既存の honda-sakubun スキルは以下の構造になっている。

.claude/skills/honda-sakubun/
├── SKILL.md
└── references/
    ├── modification-order.md  # 修飾語の順序
    ├── punctuation.md         # テンの打ち方
    └── particles.md           # 助詞の使い方

この構造を踏襲して、新しい書籍からもスキルを生成する。