mcpField
B
book-to-skill

book-to-skill

github.com/huntsyeaエージェントワークフロー3197 回インストール39 週間前に更新
リポジトリ

book-to-skill について

book-to-skillは、書籍の要約ではなく、フレームワークや原則、手法、アンチパターン、著者の文体を抽出し、実践的なClaude Codeスキルに変換します。全体変換、分析のみ、既存分析からの生成に対応します。

主な機能

  1. 01フレームワークと原則の抽出
  2. 02手順付き手法の整理
  3. 03アンチパターンと著者の文体の特定
  4. 04分析のみと全体生成に対応
  5. 05TXT以外の形式変換を案内

活用シーン

  1. 01TXTの書籍を再利用可能なスキルに変換
  2. 02生成前に抽出内容を確認
  3. 03既存の分析からスキルファイルを生成

インストール

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

$npx skills add https://github.com/huntsyea/thinking-skills --skill book-to-skill

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

同梱ファイル

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

references/
extraction-patterns.md
reference-file-templates.md
skill-patterns.md
workflows/
analyze-book.md
convert-book.md
convert-formats.md
generate-skill.md

詳細

書籍からスキルへの変換

書籍の知識を、実践に役立つ Claude Code スキルに変換します。

基本方針

書籍に凝縮された専門知識、つまりフレームワーク、原則、テクニックを抽出し、繰り返し活用できる形式にすることで、書籍を実践に役立つスキルに変換します。

要約ではなく、構造を抽出します。 スキルは書籍のレポートではありません。次のようなツールキットです。

  • 名前のあるフレームワーク(明確な適用方法を備えた思考モデル)
  • 実践的な原則(意思決定の指針となるルール)
  • テクニック(段階的な手法)
  • アンチパターン(避けるべきこととその理由)
  • 文体の調整(著者の思考や伝え方)

著者の正確さを保ちます。 フレームワークには、特定の名前や構造が付けられていることがよくあります。それには理由があります。「5回のなぜ」は「何度か理由を尋ねる」と同じ意味ではありません。正確な表現を記録します。

呼び出しやすさを重視します。 生成されるスキルは、すぐに役立つものであるべきです。誰かが /author-method を呼び出したとき、哲学ではなく、実践に役立つガイダンスが得られるようにします。

適切な深さで構成します。 シンプルな書籍からはシンプルなスキルを作成します。10 個以上のフレームワークを含む複雑な書籍からは、参照ファイルを備えたルータースキルを作成します。

対応形式

主な形式: .txt ファイルは、このスキルでそのまま使用できます。

変換が必要な形式: epub、pdf、mobi、docx

他の形式の書籍を分析する前に、.txt に変換してください。

# EPUB → TXT
ebook-convert book.epub book.txt

# PDF → TXT
pdftotext book.pdf book.txt

手順と依存関係の詳細は、workflows/convert-formats.md を参照してください。

開始方法

次の 3 つの方法を利用できます。

1. 全体を変換(デフォルト)

トリガー: ユーザーが .txt の書籍ファイルを指定する アクション: workflows/convert-book.md に処理を振り分ける 出力: すべてのファイルを含む完成したスキル

2. 分析のみ

トリガー: ユーザーが「分析して」や「抽出だけ」と指定する、または生成前に内容を確認したい アクション: workflows/analyze-book.md に処理を振り分ける 出力: 構造化された抽出レポート(スキルは生成しません)

3. 以前の分析結果から生成

トリガー: ユーザーが既存の分析メモを持っている、または以前に分析のみを実行している アクション: workflows/generate-skill.md に処理を振り分ける 出力: 提供された分析結果から生成したスキルファイル

振り分けロジック

IF user provides non-.txt file (epub, pdf, mobi, docx):
  → Point to workflows/convert-formats.md first

IF user provides .txt book file path:
  IF "analyze only" or "just analyze" in request:
    → workflows/analyze-book.md
  ELSE:
    → workflows/convert-book.md

IF user mentions "generate" or "create skill" with analysis notes:
  → workflows/generate-skill.md

IF unclear:
  Ask: "Do you want to:
  1. Convert a book to a skill (provide .txt path)
  2. Analyze a book without generating (provide .txt path)
  3. Generate a skill from existing analysis"

抽出カテゴリについては、references/extraction-patterns.md を参照してください。 出力構造のパターンについては、references/skill-patterns.md を参照してください。

質問事項

以下の各項目について、AskUserQuestion ツールを使用してください。

  1. 目的(分析前):

    • 質問:「このスキルを使って何ができるようにしたいですか?」
    • 選択肢:著者のように書く | 著者のフレームワークを適用する | 著者の思考モデルを使って考える | 著者のアプローチで構築する | すべて
  2. スキル名(分析後):

    • 質問:「このスキルの名前は何にしますか?」
    • {author-lastname}-{core-concept} 形式を提案する
    • 例:cialdini-influence、meadows-systems、kahneman-decisions
  3. 範囲(抽出後):

    • 抽出した要素の概要を提示する
    • 質問:「どの要素をスキルに含めますか?」
    • 選択肢:抽出した内容すべて | 特定のフレームワークのみ | 指定する
  4. 参照資料の詳細度:

    • 質問:「参照資料はどの程度詳しくしますか?」
    • 選択肢:必要最小限(主要なフレームワーク) | 包括的(すべてのフレームワークと原則) | 網羅的(抽出したすべての内容)

コメント