1. プロジェクト概要
Vibe-Skills（VibeSkills）は、大規模なローカル「スキル」ライブラリを自動的に発見・ルーティング・調整する汎用オーケストレーションスキルです。これにより、AIコーディングエージェントは、開発者がサブタスクごとに適切なツールを手動で選ぶことなく、複雑なマルチステップタスクを計画・実行・検証できます。
2. 背景と位置づけ
「エージェントスキル」エコシステム（Claude Code Skills、Codexスタイルのハーネス、類似のエージェントフレームワーク）が成長するにつれ、開発者はデータサイエンスからセキュリティレビュー、ドキュメント作成までをカバーする数十〜数百の個別スキルをローカルにインストールすることになります。どのスキルをどの順序で呼び出すべきか、結果が要求と実際に一致しているかをどう確認するか、を覚えておくこと自体が管理上の問題になります。
Vibe-Skillsは、そのメタ問題を解決するために作られました。さらに特化したスキルを追加するのではなく、ライブラリ全体の上位に位置するルーター兼オーケストレーターとして機能します。まずユーザーと要件を確認し、タスクの規模を見積もり、各作業モジュールに関連するスキルを絞り込み、セッション全体の実行状態を追跡し、計画と実際の成果を比較する受入レポートを生成します。
これは、独立した単一目的のスキルをフォルダにまとめただけの一般的なスキルコレクションとは異なり、Vibe-Skillsはワークフローレイヤーを追加します。タスク計画、ライブラリ全体をコンテキストに読み込まずに行うスキル発見、セッションをまたぐ進捗の永続化、タスク完了とみなす前の正式な検証ステップです。また、250以上のコミュニティスキルをバンドルしており、オーケストレーターとしても、すぐに使えるスキルパックとしても利用できます。
3. 機能カテゴリ
- 🧭 オーケストレーションコア — 要件確認、複雑性評価（
--l/--xl）、スキル割り当て、実行追跡を担当するエンジン。例：core/skill-contracts、agents/計画テンプレート、protocols/通信仕様、adapters/（各種ホストアプリケーション用）。目的：自然言語のリクエストを、調整された監査可能な計画に変換する。 - 🔬 科学・データスキル — 最大のバンドルカテゴリで、バイオインフォマティクス、統計、ML研究をカバー。例：
biopython、astropy、rdkit、scanpy、pymc-bayesian-modeling、scikit-learn、pytorch-lightning。目的：科学計算・データ分析タスクにエージェントへドメイン固有の専門知識を提供する。 - 🛡️ セキュリティ・品質スキル — レビューおよび堅牢化ツール。例：
security-reviewer、security-best-practices、security-threat-model、security-ownership-map、code-reviewer。目的：エージェント駆動開発中に脆弱性を検出し、コード品質ゲートを実施する。 - 📝 ドキュメント・ライティングスキル — コンテンツおよびテクニカルライティング支援ツール。例：
docs-write、docs-review、writing-plans、scientific-writing、markdown-mermaid-writing。目的：一貫性のある高品質な文書成果物を生成・維持する。 - ⚙️ DevOps・デプロイスキル — 統合およびデプロイ支援ツール。例：
netlify-deploy、vercel-deploy、skypilot-multi-cloud-orchestration、mcp-integration、gh-fix-ci。目的：エージェントワークフローから直接、出荷およびインフラタスクを自動化する。 - 📊 可視化・レポートスキル — チャートおよびレポート生成ツール。例：
creating-data-visualizations、matplotlib、plotly、scientific-slides、report-generator。目的：生の分析結果をプレゼンテーション可能な成果物に変換する。
4. 主な特長
- 作業開始前の要件確認 — オーケストレーターが事前にユーザーとスコープ・制約を明確化し、タスクの誤解による無駄な作業を削減。
- コンテキスト効率の良いスキル発見 — 設定済みフォルダ内の
SKILL.mdファイルをスキャンし、関連する候補のみを絞り込むため、250以上のスキルライブラリ全体をモデルのコンテキストウィンドウに読み込む必要がない。 - セッション継続性 —
session_rootフォルダが入力、進捗、決定を永続化するため、マルチステップタスクを最初からやり直すのではなく再開できる。 - 正式な成果物検証 —
delivery-acceptance-reportが承認済み作業計画（module-work-plan.json）と実際の実行（module-execution.json）を比較し、合格・不合格・ブロックされた項目をフラグ付けする。 - 複雑性に応じたワークフローレベル —
--lおよび--xlフラグでユーザーがタスクの規模を指定でき、オーケストレーターはそれに応じて計画の深さを調整。 - 250以上のバンドルスキルをすぐに利用可能 — 科学、セキュリティ、DevOps、ドキュメントなどを網羅し、直接またはオーケストレーター経由で利用可能。
5. 役割別ユースケース
- 一般開発者：
$vibe//vibeを使用して、曖昧な機能リクエストをスコープ定義済みの計画に変換し、適切なバンドルスキル（コードレビュー、ドキュメント、テスト）を自動適用し、最後に検証レポートを取得。 - DevOps/SRE：オーケストレーターが調整するデプロイ指向スキル（
netlify-deploy、vercel-deploy、skypilot-multi-cloud-orchestration）を活用し、マルチステップのリリース・インフラタスクを実行。 - セキュリティエンジニア：
security-reviewer、security-threat-model、security-ownership-mapを通じてレビュータスクをルーティングし、オーケストレーターがどのチェックが合格したか、ブロックされたかを追跡。 - データ/研究科学者：科学計算スキル（biopython、astropy、pymc、scikit-learnなど多数）の大規模カタログに、各ツールの呼び出し方を個別に覚えることなくアクセス。
- プロジェクトマネージャー：計画および受入レポート成果物（
module-work-plan.json、delivery-acceptance-report.md）を、要求事項と成果物を比較する軽量な監査証跡として使用。
6. はじめに
必要なものを見つける — bundled/skills/ のバンドルカタログを閲覧するか、docs/quick-start.en.md で利用可能な機能の概要を確認。
インストール/統合 — 公開リリースアーカイブ（生のリポジトリチェックアウトではない）をダウンロードし、スキルディレクトリにインストール：
# Windows
./update.ps1 -SkillsDir <skills-dir>
# macOS / Linux
./update.sh --skills-dir <skills-dir>
AIアプリケーションのスキルエントリポイントから呼び出し：
$vibe
または
/vibe
コントリビュート — CONTRIBUTING.md を読み、references/contributor-zone-decision-table.md のゾーンテーブルと references/change-proof-matrix.md の証明マトリクスを確認し、変更タイプに応じた文書化されたエビデンス要件に従ってプルリクエストを開く。
7. プロジェクト構造
Vibe-Skills/
├── core/ # オーケストレーションエンジンとスキルコントラクト
├── agents/ # 計画テンプレート
├── adapters/ # ホストアプリケーション用統合インターフェース
├── protocols/ # コンポーネント間の通信仕様
├── commands/ # CLIエントリポイント
├── bundled/skills/ # 250以上のすぐ使えるコミュニティスキル
├── docs/ # アーキテクチャ、ガバナンス、インストール＆クイックスタートガイド
├── tests/ # 検証スイート
├── update.sh / update.ps1 # インストール/更新スクリプト
└── check.sh / check.ps1 # インストール検証
主要ファイル：SKILL.md（オーケストレーター自身のスキル定義）、CONTRIBUTING.md（コントリビューションルール）、docs/quick-start.en.md（はじめにガイド）。
8. 関連エコシステム
Vibe-Skillsは、Claude Codeや類似のエージェントフレームワークなど、ローカルの「スキル」概念をサポートするAIコーディングハーネス内で動作するように設計されています。バンドルされたスキルの多くは、各ドメインのよく知られたオープンソースライブラリをラップまたは補完します。例えば、科学計算分野では scikit-learn、pytorch-lightning、matplotlib、biopython、Model Context Protocol サーバーへの接続には mcp-integration などです。
9. ライセンス
Apache License 2.0 の下でライセンスされています。
- ✅ 商用利用、改変、配布、私的利用が許可されています。
- ✅ 帰属表示を保持する限り、改変版を自身のプロジェクトの一部としてサブライセンスできます。
- ❌ 保証は提供されず、著者は使用に起因する損害について責任を負いません。
- ℹ️ サードパーティコンポーネントは
NOTICEおよびTHIRD_PARTY_LICENSES.mdで個別に帰属表示されています。バンドルされたスキルライブラリを再配布する場合は、これらのファイルを確認してください。
10. FAQ
Q: リポジトリをクローンしてインストールしますか？
A: いいえ — ドキュメントでは、公開リリースアーカイブからインストールすることを指定しており、生のリポジトリチェックアウトからはインストールしません。docs/quick-start.en.md を参照してください。
Q: インストール後、Vibe-Skillsをどう呼び出しますか？
A: AIアプリケーションのスキルエントリポイントから、通常は $vibe または /vibe で呼び出します。例：「この要件を明確化して計画に変換してください $vibe」。
Q: --l と --xl フラグは何を意味しますか？
A: これらはオーケストレーターにタスクの想定規模を伝えます。--l は管理可能な作業、--xl はより大規模で複雑なプロジェクト用で、それに応じて計画を立てます。
Q: 更新後にインストールが正常かどうか確認するには？
A: check.sh（Windowsでは check.ps1）を実行して、インストーラー管理ファイルが存在し変更されていないことを確認します。
Q: オーケストレーターなしでバンドルスキルを使用できますか？
A: はい — bundled/skills/ 以下の各スキルは、独自の SKILL.md を持つ自己完結型フォルダであり、独立して使用できます。
11. クイックリンク
- リポジトリ：https://github.com/foryourhealth111-pixel/Vibe-Skills
- クイックスタートガイド：
docs/quick-start.en.md - コントリビューションガイド：
CONTRIBUTING.md - コミュニティ：リポジトリのGitHub Issuesおよびプルリクエスト
12. まとめ
Vibe-Skillsは、成長するエージェントスキルエコシステムにおける実際の課題、つまり多数のインストール済みツールのどれをどの順序で使用するか、結果が要件を実際に満たしているか、という問題に対処します。科学、セキュリティ、DevOps、ドキュメントを網羅する250以上のスキルバンドルライブラリと組み合わせることで、大規模なスキルライブラリを運用するチーム向けのオーケストレーションレイヤーとしても、手動でのツール選択なしに幅広い機能を求める個人開発者向けの既製ツールキットとしても価値があります。