SYuan03/Skill-Anything

Any source (PDF, video, web, audio, text) to interactive learning package with quizzes, flashcards and spaced repetition. One command, 12-section study guide.

Skill‑Anything

何であるか – PDF、動画、ウェブページ、プレーンテキストファイル、音声、またはコードリポジトリといった任意の種類の資料を 構造化された学習パック に変換する Python CLI / ライブラリです。パックには12セクションの学習ガイド、クイズ、フラッシュカード、演習問題、用語集、概念マップ画像、およびオプションで AIエージェントスキル（SKILL.md）が含まれます。これは Claude Code、Cursor、Codex などのツールで利用可能です。

なぜ重要か – 人間の学習は受動的な読書に苦しんでいます。Skill‑Anything は教育者が通常手動で行うすべてのプロセスを自動化します：要約、キーポイントの抽出、アクティブリコール用アイテムの生成、学習パスの整理。これらすべては LLM 呼び出し（OpenAI互換 API であれば何でも）によって駆動され、一度パックが生成されれば完全にオフラインで実行可能です。

コア機能（README に記載）

ソース非依存のインジェスト – PDF（アウトライン対応）、ウェブページ、YouTube/動画の字幕、音声（Whisper）、プレーンテキスト、または完全な Git リポジトリ。
セクション対応のマップ・リダスパイプライン – 各セクションが並列で要約され、その後グローバルなリダスステップで最終ガイドが作成されます。並列処理のデフォルトは6で、カスタマイズ可能。
キャッシュ – プロンプト + モデル + バージョンの SHA-256 ハッシュをディスクに保存。同じ LLM 呼び出しは繰り返し実行時にスキップされます。
二段階モデルルーティング – 各セクションの「マップ」呼び出しには高速モデル、最終的な「リダス」にはより知的なモデルを使用。
12セクション出力 – 要約、概念マップ、アウトライン、詳細ノート、キーコンセプト、用語集、クイックリファレンス、要点、クイズ、フラッシュカード、演習問題。
複数のエクスポート形式 –
- --format all → 学習ガイド、YAMLパック、オフラインウェブサイト、Anki TSV、SKILL.mdバンドル。
- --format web → シングルコンテナの index.html（CDN不要、オフラインで動作）。
- --format anki → Ankiインポート用に準備された UTF-8 TSV、HTMLフィールドとタグ付き。
- --format skill → AIエージェント用に準備された SKILL.md、アセット、参照、スクリプトを含むディレクトリ。
引用情報対応生成（v0.4.1） – クイズ／フラッシュカード／演習問題には、元のテキストと照合された正確な引用文が含まれます。
CLIユーティリティ – sa audit（CIスタイルの検証）、sa share（ウェブバンドルをZIP化して送信）、sa lint（スキルパッケージの検証）、インタラクティブな sa quiz と sa review コマンド。
拡張可能な設定 – APIベース、モデル名、並列度、キャッシュ制御などに環境変数を使用可能。

一般的なワークフロー

# 1️⃣ インストール（編集可能な開発版または PyPI から）
pip install skill-anything[all]   # またはリポジトリをクローン後に pip install -e .[all,dev]

# 2️⃣ LLM資格情報の設定
cp .env.example .env && nano .env   # API_KEY、API_BASE、モデル名を設定

# 3️⃣ 任意のソースからパックを生成
sa pdf textbook.pdf --format all          # PDF → 全パック + ウェブ + Anki + スキル
sa repo https://github.com/openai/openai-python --format study
sa video https://youtu.be/… --format web

# 4️⃣ 出力の共有または利用
sa share output/textbook.yaml               # index.html + ZIP を作成
sa export output/textbook.yaml --format anki # Ankiインポート用の TSV
sa export output/textbook.yaml --format skill # AIエージェント対応の SKILL.md バンドル

# 5️⃣ ローカルで対話
sa quiz output/textbook.yaml                # インタラクティブクイズ（6種類）
sa review output/textbook.yaml              # フラッシュカードの間隔反復モード

だれが使うべきか？

学生・自己学習者 – 講義動画や教科書の章を、クイズやフラッシュカード付きの学習準備完了のガイドに変換。
チームリーダー（新入社員オンボーディング用） – コードリポジトリを sa repo に投入してオンボーディングパック（用語集、概念、演習問題）と、コードベースに関する質問に答えることができるAIエージェントスキルを生成。
教育者・コンテンツクリエイター – 既存リソースから迅速に学習資料を生成し、Ankiや静的ウェブサイトとして配布可能。
AIツール開発者 – SKILL.md エクスポートを活用して、特定ドメイン用の構造化知識ベースをエージェントに提供。

インストールと要件

Python 3.10 以上。
特定のソースタイプ用のオプション拡張（pdf、video、web、audio）。
最高品質の出力を得るには OpenAI互換 API キーが必要。キーがなければルールベース生成にフォールバック。
PyPI からインストール：
```
pip install skill-anything[all]
```
またはリポジトリをクローンして開発用に編集可能モードでインストール。

ライセンス

MIT – パーミッシブなオープンソースライセンス。