sickn33/agentic-awesome-skills

AAS Core – Agentic Awesome Skills (AAS)

何であるか

• 大規模言語モデルエージェント（例：OpenAI Codex、Anthropic Claude）がローカルカタログ内の2,115以上の再利用可能な「スキル」プレイブックを検索し、プロジェクトに必要な正確なIDを選択し、選択内容を記録する機械可読のマニフェスト（aas-stack.json）を生成できるライブラリおよびCLI。
• コアコンポーネントは読み取り専用：選択されたスキルのIDと構造を検証するが、ランク付け、推薦、実行は行わない。別途CLIで不変の計画をプレビューし、ローカルディレクトリにスキルディレクトリをコピーする直接インストーラーをドライランできる。

なぜ重要か

• エージェントはコードベース上で行動するためには具体的な指示（例："ブレインストーミング"、"体系的デバッグ"）が必要となる。AASは安定した、検査可能な真実の源を提供し、同じ指示セットを後でレビュー、バージョン管理、再現可能にする。
• カタログファイルはすべてプレーンテキスト（SKILL.md）なので、コードを実行せずに検査可能であり、ワークフローを安全かつオフラインに保てる。

主要な概念

概念	役割
カタログ	各々が再利用可能な指示セットを記述する SKILL.md ファイルのディレクトリ。
MCP（Model-Control-Plane）	LLMが呼び出すコマンド（例：search_skills、get_skill、compose_stack など）を公開するローカル、読み取り専用サービス。
エージェント所有のコンポジション	LLM（CodexまたはClaude）が使用するスキルIDを決定する。AASはリストの検証のみを行う。
aas-stack.json	ターゲットプロジェクトに選択された正確なスキルIDを記録するJSONマニフェスト。
選択証拠	オプションのサイドカー（aas-selection-evidence.json）で、各スキルが選ばれた理由をログに記録。
CLI	aas stack validate でマニフェストを検証；aas stack plan で読み取り専用の計画を作成；aas stack install-preview で直接インストーラーをドライラン可能。
ワークベンチ	マニフェストと計画を読み込むブラウザ専用UI。ファイルシステムへの書き込みは一切行わない。

典型的なワークフローの流れ

1. ローカルMCPの設定（プレビューガイドに起動方法が記載）。
2. LLM（Codex/Claude）にリポジトリを検査させ、MCPを使って関連するスキルをカタログから検索させる。
3. モデルがスキルIDのリスト（例：brainstorming、systematic-debugging）を返す。
4. MCPが compose_stack を実行し、IDが存在し、構造的制限（最大128スキル）を満たしているかを検証する。
5. クライアントまたは aas CLIが aas-stack.json（およびオプションで証拠ファイル）を書き込む。
6. aas stack validate を実行してマニフェストを再確認し、aas stack plan を実行してターゲット用の不変計画を確認する。
7. （オプション）直接インストーラー（npx agentic-awesome-skills … --dry-run）を使用して、選択されたスキルディレクトリを ~/.agents/skills にコピーするプレビューを行う。
8. 人間による承認後、--dry-run を削除してインストールコマンドを再実行し、スキルを実際に配置する。

インストールとエントリポイント

• npmパッケージ: npm exec --yes --ignore-scripts --package=agentic-awesome-skills@<version> -- agentic-awesome-skills …
• npxショートカット: npx agentic-awesome-skills --skills <comma-list> --dry-run（プレビュー）または --antigravity でAntigravityスタイルのターゲットを指定。
• GitHub CLI（プレビュー）: gh skill preview … / gh skill install … で単一スキルを処理。
• インストーラーはリポジトリの浅い部分的クローンを行い、npmパッケージメタデータのコミットハッシュと照合し、要求されたスキルディレクトリのみをコピーする。

専用プラグイン

• リポジトリには事前にバンドルされたプラグインパック（例：Web App Builder、Security Engineer、DevOps & Cloud）が同梱されており、特定のドメイン向けに関連するスキルをグループ化している。
• プラグインはClaude-CodeおよびCodex互換のバンドルとして生成され、標準のAgent Plugins 1.0マニフェストも公開している。

セキュリティと制限

• AASはスキルコードを実行しない。ファイルのコピーのみを行う。
• コアは意味的適切性を保証しない—LLMの選択が環境に適切でない可能性がある。
• 特定のスキルは重要または攻撃的とマークされ、インストーラーはリスク要約を出力し、フルカタログの取得には明示的な承認（--all）が必要。
• 適用/回復機能は実験的とマークされており、サポートされているプレビューでは無効になっている。

使用すべき場面

• LLM駆動の開発パイプラインがあり、モデルが実行可能な再現可能で監査可能な指示リストを必要としている場合。
• ファイルが書き込まれる前にモデルが選択した内容を正確にレビューしたい場合（コンプライアンス、セキュリティ、チームレビューの文脈）。
• リモートサービスに依存せずに、プロジェクトやチームメンバー間でカスタマイズされたスキルセットを共有したい場合。

使用しない方が良い場面

• skills/ フォルダの単純なキーワード検索のみが必要な場合、AASは追加の検証とマニフェスト処理を追加するため、必要ない可能性がある。
• スキルの自動実行が必要なプロジェクト（例：CI/CDランナー）は、独自のランナーを構築する必要がある。AASは静的指示のみを提供する。

さらに学ぶには

• ユーザーガイド: docs/users/aas-core.md（信頼境界、MCP設定、CLIライフサイクル）。
• ワークフローと事例研究: docs/users/workflows.md。
• セキュリティと監査: docs/users/security-and-antivirus.md。
• プラグインカタログ: plugins/ ディレクトリおよびホスティングされたランディングページ https://sickn33.github.io/agentic-awesome-skills/plugins。

---

結論：AAS Coreはプレビュー段階の、ローカルで実行可能なツールキットであり、再利用可能な指示「スキル」の大きな検査可能なライブラリからAIエージェントが選択し、選択内容を再現可能なマニフェストに記録する。LLM駆動の自動化の力を得つつも、インストールされる内容に対する完全な監査可能性とコントロールを維持したいチームに向けられている。