chubbyguan/chubbyskills

Chubby Skills – クリエイター向けローカルナレッジベースツールキット

概要

• 14 の Agent Skills とコマンドラインインターフェースのコレクションで、動画、ポッドキャスト、記事、ローカルドキュメントをキャプチャし、検索可能な Markdown ファイルに変換し、エージェントが消費できる エビデンスベース のマテリアルパックをエクスポートできます。
• コアワークフローは完全にオフラインで動作 – オプションの文字起こしやエンリッチメント機能を有効にしない限り、サードパーティのパッケージ、API キー、モデルのダウンロードは不要です。

主な機能

領域	できること
キャプチャ	B 站/YouTube から字幕を取得、TikTok/抖音/微博/知乎 動画を文字起こし、X/Twitter 投稿を取得、WeChat 公開記事をスクレイピング、ローカル Markdown/TXT/PDF（テキスト層のみ）をインポート。
インポートとインデックス	すべてを front-matter（タイトル、ソース URL、著者、タイムスタンプ、いいね数など）付きの Markdown に変換し、添付ファイルをローカルに保存し、検索可能なインデックス（キーワード + オプションのセマンティックライト）を構築。
検索と取得	キーワードでスニペットを検索（オプションのベクターストアをインストールした場合はセマンティック検索も可能）、元の行番号、ソース URL、検証用の SHA-256 ハッシュを表示。
エクスポート	ブリーフ を生成 – 正確な抜粋、行番号、ソースメタデータ、ハッシュを含む Markdown/JSON パッケージで、LLM エージェントが下書きやトピック選択に使用できます。
サブスクリプション	RSS/YouTube チャンネルまたはポッドキャストのサブスクリプションを設定し、定期的に新しいアイテムを取得して取り込みキューに入れ、オプションでデイリーダイジェストを生成（LLM 不要、オプションの DeepSeek 要約）。
エージェント統合	ナレッジベーススキルパッケージを Claude Code、OpenCode などのエージェントにインストールするか、検索、取得、インデックス API を提供する軽量 MCP サーバーを実行。

始め方（クイックラン）

1. リポジトリをクローンして vault を初期化：

   git clone https://github.com/chubbyguan/chubbyskills.git
   cd chubbyskills
   python3 tools/chubby.py init --vault "$PWD/creator-vault"
   

2. 公開 X 投稿をキャプチャ（追加依存不要）：

   python3 tools/chubby.py ingest "https://x.com/OpenAI/status/1663696190960173056" --no-enrich
   python3 tools/chubby.py search "ChatGPT"
   

3. ソース付きブリーフをエクスポート：

   python3 tools/chubby.py brief --topic "ChatGPT" --output "$PWD/creator-vault/30_Output/brief.md"
   

   生成された brief.md には、正確な抜粋、行番号、元の URL、SHA-256 ハッシュが含まれます。

インストールオプション

• ゼロ依存 CLI – クローン後に python3 tools/chubby.py … を直接実行（Python 3.11+）。
• 編集可能パッケージ – pip install -e . で chubby コマンドが利用可能。
• フルスキルインストール – python3 tools/install_skill.py --all --dest /path/to/agent/skills で 14 のスキルディレクトリをエージェントのスキルフォルダにコピー。
• オプションの追加機能 – bash setup.sh light（Python のみチェック）、bash setup.sh video（ffmpeg とローカル文字起こしモデルを追加）、bash setup.sh podcast（funasr を追加）、または プラットフォーム機能 テーブルに記載されている yt-dlp、pymupdf などをインストール。

典型的なユースケース

• コンテンツクリエイター が後で執筆するために完全な引用データ付きのソース素材（ツイート、YouTube 動画、ポッドキャスト）の個人アーカイブを保持する必要がある場合。
• 研究者 / ナレッジワーカー が生のコンテンツをクラウドに送信せずに LLM エージェントがクエリできるローカルエビデンスベースを構築する場合。
• エージェント が検索可能なナレッジベースを必要とする場合 – MCP サーバーは search、read、index などのユーティリティを公開し、シームレスな統合を実現します。

制限と注意点

• プラットフォームのスクレイピングはサイトの公開 API を尊重します。アンチスクレイピング対策をバイパスすることは ありません。一部のサイトでは、有効な cookies を提供しない限りプレビューのみを返す場合があります（例：X の長文記事）。
• 動画/音声の文字起こしは外部ツール（ffmpeg、funasr、オプションの Qwen-ASR）に依存し、初回実行時にモデルのダウンロードが必要な場合があります。
• セマンティック検索とコンテンツエンリッチメント（要約、タグ）はオプションで、API キー（DeepSeek、OpenAI など）が必要です – これらはコアのオフラインフローには含まれません。
• PDF インポートはテキスト層のみを抽出します。スキャンされた PDF は事前に OCR が必要です。
• このツールは個人の非商用利用を目的としています。コンテンツを保存および再利用する際は、著作権とプラットフォームの利用規約を尊重する必要があります。

詳細情報

• クイックスタートガイドと詳細ドキュメントは docs/ フォルダにあります（インストール、クリエイターワークフロー、サブスクリプション、MCP 設定、プラットフォームフォールバックなど）。
• 出力例は examples/README.md にあります。
• コミュニティディスカッション、バグレポート、機能リクエストはリポジトリの Discussions と Issues セクションにあります。

---

Chubby Skills は、生のインターネットコンテンツと、AI エージェントに直接供給できる構造化された引用豊富なナレッジベースの間のギャップを埋め、データを自分のマシンに保持します。