Repolode
投稿する
virgiliojr94

virgiliojr94/book-to-skill

技術書やドキュメント集を、AIコーディングアシスタントが必要に応じて読み込める、構造化されたエージェントスキルに変換します。

GitHub で見る
スター
35,351
フォーク
3,728
未解決の Issue
24
最終コミット
一昨日

これは何？

book-to-skillは、PDF、EPUB、DOCX、Markdown、HTMLなどのドキュメントや、複数の資料を含むフォルダを受け取り、Agent Skillsパッケージにまとめます。出力には、基本となるメンタルモデルと章のインデックスを記載したSKILL.md、必要に応じて読み込まれる章ごとのファイルのほか、用語集、パターン集、チートシートが含まれます。単なる要約ではなく、本の構造をエージェントに渡すことで、実際の章の内容に基づいて質問に答えられるようにすることが目的です。

このツールは、Claude Code風のスラッシュコマンドとして動作します。決定論的なPython抽出器がソースを整形済みテキストとメタデータに変換し、その後、エージェントがジェネレーターの仕様に従ってスキルを構築します。インストールしたスキルはエージェント共通のskillsディレクトリに配置され、GitHub Copilot CLI、Amp、Codex、OpenCode、OpenClawなどのホストから読み込めます。Claude CodeとHermes Agentについては、それぞれ固有の配置場所を使用します。

同じ方法は、社内ドキュメント、ブランドガイドライン、研究論文集、頻繁に参照する仕様書にも適用できます。著作権で保護された資料は、ユーザーが所有するコピーをローカルで処理し、非公開に保つことを想定しています。

主な機能

  • 01PDF、EPUB、DOCX、HTML、RTF、MOBI、MarkdownのソースをAgent Skillsパッケージに変換します。
  • 02SKILL.mdのインデックスと、話題について質問されたときだけ読み込まれる章ごとのファイルを生成します。
  • 03章ごとのファイルに加えて、用語集、パターン集、チートシートを生成します。
  • 04インストール済みのツールを報告する--checkコマンドを備えた、決定論的な抽出器が含まれています。
  • 05Agent Skills標準に対応する複数のエージェントホストで利用できます。

ユースケース

  • コーディング中にClaude CodeやCopilot CLIから技術書の内容を検索する。
  • アーキテクチャ決定記録や運用手順書をまとめたフォルダを、チーム向けのスキルに変換する。
  • 複数の研究論文や個人メモを、エージェントが検索できるようにする。
  • エージェントに特定の章や概念について質問し、内容の難しい本を学ぶ。

クイックスタート

  1. 1

    cross-agent skills CLI でスキルをインストールする

    npx skills add virgiliojr94/book-to-skill
  2. 2

    インストール済みの抽出ツールを確認し、不足しているツールのインストールコマンドを取得する

    python3 scripts/extract.py --check
  3. 3

    AI コーディングアシスタントから書籍やドキュメントのフォルダーをスキルに変換する

    /book-to-skill <path|folder|glob> [skill-name]

使う前に知っておきたいこと

  • Claude Code や Codex など、Agent Skills 標準に対応した AI コーディングアシスタントが必要です。
  • テキストレイヤーのないスキャン PDF は、先に OCR を実行してください。実行しないと抽出ツールが停止します。
  • PDF、EPUB、DOCX、MOBI の抽出にはオプションのツールが必要です。別途インストールが必要な場合があります。

トピック

#agent-skills#ai-agents#pdf-to-markdown#knowledge-base#rag#self-study#book-to-skill#context-engineering#document-processing#edtech

よくある質問

book-to-skill とは？
技術書やドキュメント集を、AIコーディングアシスタントが必要に応じて読み込める、構造化されたエージェントスキルに変換します。 book-to-skillは、PDF、EPUB、DOCX、Markdown、HTMLなどのドキュメントや、複数の資料を含むフォルダを受け取り、Agent Skillsパッケージにまとめます。出力には、基本となるメンタルモデルと章のインデックスを記載したSKILL.md、必要に応じて読み込まれる章ごとのファイルのほか、用語集、パターン集、チートシートが含まれます。単なる要約ではなく、本の構造をエージェントに渡すことで、実際の章の内容に基づいて質問に答えられるようにすることが目的です。
book-to-skill は無料で使えますか？ライセンスは？
book-to-skill は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
book-to-skill は今もメンテナンスされていますか？
活発にメンテナンス中。book-to-skill の最終コミットは 2026年10月18日 です。
book-to-skill は何に使えますか？
コーディング中にClaude CodeやCopilot CLIから技術書の内容を検索する。 アーキテクチャ決定記録や運用手順書をまとめたフォルダを、チーム向けのスキルに変換する。 複数の研究論文や個人メモを、エージェントが検索できるようにする。 エージェントに特定の章や概念について質問し、内容の難しい本を学ぶ。
book-to-skill のインストール方法は？
cross-agent skills CLI でスキルをインストールする: npx skills add virgiliojr94/book-to-skill インストール済みの抽出ツールを確認し、不足しているツールのインストールコマンドを取得する: python3 scripts/extract.py --check AI コーディングアシスタントから書籍やドキュメントのフォルダーをスキルに変換する: /book-to-skill <path|folder|glob> [skill-name]
book-to-skill はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/virgiliojr94/book-to-skill

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト