virgiliojr94/book-to-skill

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

📚 book-to-skill – 任意の技術書（または類似のドキュメントコレクション）を、AIアシスタントがオンデマンドでクエリ可能なエージェントスキルに変換します。

機能

入力: PDF、EPUB、DOCX、MD、HTML、RTF、MOBI、フォルダ、またはそのグロブパターン。
出力: オープンな エージェントスキル 標準に従うディレクトリ（SKILL.md と各チャプター用のMarkdownファイル、用語集、パターン、チートシートなど）。
生成されたスキルはホストのスキルフォルダ内に保存されます（~/.copilot/skills/…、~/.agents/skills/…、~/.claude/skills/…）。
LLMエージェント（GitHub Copilot CLI、Amp、Claude Code）が /my-book replication のようなコマンドを受け取ると、関連するチャプターのみをロードするため、プロンプトに全体の本を投入する場合と比べて 24〜51倍少ないトークン でクエリが可能になります。

なぜ重要なのか

本を一度読んだ後、詳細を忘れてしまうのはよくあること。PDFを検索してもページ番号しか返らず、LLMに尋ねても幻覚が生じることが多い。
本の内容を構造化された知識（フレームワーク、意思決定ルール、反パターン、インデックス付きチャプター）に精製することで、エージェントは 正確かつオンデマンドで 元のコンテンツにアクセスでき、毎回ファイル全体を再スキャンする必要がありません。
エージェントスキル仕様をサポートするすべてのホストと互換性があり、Copilot CLI、Amp、Claude Codeなど間でスキルをポータブルに利用できます。

生成される内容（例：構成）

ファイル	役割	およそサイズ
`SKILL.md`	コアなマインドセット + チャプターインデックス	~4 kトークン
`chapters/ch01-*.md` …	チャプターごとに1つのMarkdownファイル。必要時にのみロード	各 ~1 kトークン
`glossary.md`	キーワードのアルファベット順リストとチャプター参照	~1.5 kトークン
`patterns.md`	技術、アルゴリズム、デザインパターンの集積	~2 kトークン
`cheatsheet.md`	決定テーブル / クイックリファレンスルール	~1 kトークン

動作の概要（高レベル）

エクストラクタ（Python）: ファイルタイプを検出、適切なツール（例：pdftotext、docling、ebooklib、python-docx など）を選択し、各ソースをクリーンなテキスト + 最小限のメタデータに変換。
アナライザー: テキストをチャプターに分割、見出しを抽出、キーワード、パターン、意思決定ルールを特定。
ジェネレーター: 標準仕様に基づくテンプレートに従い、上記の SKILL.md バンドルを出力。チャプターファイルは別々に保持され、エージェントは必要最小限のファイルのみをロード。
オプションの後処理: ホスト固有のルールに従ってスキルを検証（tools/validate_skill.py）し、プライベートGitHubリポジトリに公開して共有しやすくする。

インストールと即時利用

# コンバータをクロスエージェントスキルとしてインストール（ワンライナー）
npx skills add virgiliojr94/book-to-skill

# または手動でホストのスキルディレクトリにクローン
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill

その後、コマンドを実行（ツールは /book-to-skill をCLIエントリとして登録）：

/book-to-skill ./my-book.pdf            # ファイル名からスキル名を生成
/book-to-skill ./docs/ --skill docs-kit # フォルダ全体を変換

生成されたスキルはすぐに利用可能：

/my-book replication   # 適切なチャプターを使用してエージェントに回答を依頼

本以外の典型的な利用例

社内ドキュメント（ランブック、ADR、オンボーディングガイド）→ コーディング中にクエリ可能な1つのスキル。
ブランド／デザインシステム → スタイルガイドを検索可能なスキルに変換し、コピーライターに活用。
研究資料コレクション → 論文と個人メモを統合し、更新可能な1つのスキルに。
仕様書・標準 → PDFを開かずにRFCやAPI契約をクエリ可能に。

プライバシーとライセンス

すべての抽出処理は ローカルで実行 され、ファイルはアップロードされません。
ツールは MITライセンス で提供されます。生成されたスキルは個人ノートとみなされ、著作権のあるコンテンツを再配布してはいけません。

TL;DR: book-to-skill はPythonベースのコンバータで、任意の技術書や構造化されたドキュメントコレクションを、コンパクトで標準準拠のエージェントスキルに変換し、LLM駆動のアシスタントが元の資料から質問に正確に回答できるようにします。トークン使用量は劇的に削減され、幻覚も発生しません。