mollycall-zmy/book-learning-skill

book-learning-skill は何をしますか？

体系的に書籍を学習するためのエージェントスキル：PDF/EPUB/Word/HTMLをMarkdownに変換し、章構造を保持、追跡可能な章ノート、階層型要約、アトミックナレッジカードを生成します。

概要

このスキルは、AIエージェントが書籍から知識を効率的に抽出・整理・保存できるように設計されています。入力ファイルをMarkdownに変換し、構造化された学習成果物を生成します。

主な機能

• 形式変換: PDF、EPUB、Word（.docx）、HTMLをMarkdownに変換
• 章構造の保持: 元のドキュメントの見出し階層（h1〜h6）を維持
• 章ノート: 各章ごとに引用と考察を含む詳細ノートを生成
• 階層型要約: 章単位の要約と全書籍の要約を提供
• アトミックナレッジカード: 重要な概念を独立した知識カードとして抽出

使い方

1. 学習したい書籍ファイル（PDF/EPUB/Word/HTML）を準備します。
2. エージェントにスキルを読み込ませ、ファイルパスを指定します。
3. エージェントが自動的に変換と処理を実行します。
4. 出力はMarkdownファイルとして保存されます。

サポートされるプラットフォーム

• Claude Code
• Cursor
• Codex
• その他、Markdown入力をサポートするAIエージェント

技術詳細

• 変換には pandoc または markitdown ライブラリを使用
• 出力ディレクトリ構造：

  output/
  ├── book.md                # 変換された全文
  ├── notes/
  │   ├── chapter-01.md      # 第1章のノート
  │   └── ...
  ├── summaries/
  │   ├── chapter-summary.md # 章ごとの要約
  │   └── full-summary.md    # 全書籍の要約
  └── cards/
      ├── card-001.md        # ナレッジカード
      └── ...
  

注意事項

• 大きなファイル（100MB以上）の処理には時間がかかる場合があります。
• スキャンされたPDF（画像ベース）は直接変換できません。OCR処理が必要な場合は別途前処理を行ってください。
• 出力は元のドキュメントの著作権を尊重し、学習目的でのみ使用してください。