thedivergentai/GD-Agentic-Skills

The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns, automated persona orchestration (Analyst, Auditor, Builder), and production-grade game engineering.

GD Agentic Skills – Godot 4.7+ 開発のマスタリー・エコシステム

何であるか

最適な実装方法に基づいた 99 の「ドメインスキル」（旧称：マイクロスキル）のキュレートされたコレクション。これらは Godot 4.7+ のコード、アーキテクチャパターン、プロダクション対応の GDScript スニペットをエンコードしている。
このライブラリは、AI コーディングエージェント（例：Claude Code、Cursor、Gemini‑CLI など）の外部長期記憶として設計されている。
特別なスキルである godot‑master は、すべての他のスキルを参照するオーガナイザーであり、意思決定マトリクス、アンチパターン、パフォーマンス予算を追加する。

なぜ重要か

現代の AI エージェントはしばしば「幻覚」を起こし、公式の Godot ドキュメントから逸脱したコードを生成する。
確定的でトークン効率の良い知識ベースをエージェントに供給することで、モデルのコンテキストを集中させ、出力がエンジンの最新 API と一致するようにする。
リポジトリには ビジョンスキル（godot‑agent‑vision）も同梱されており、エージェントがエディタ GUI/アセットのスクリーンショットをキャプチャし、WebP に変換し、プロダクション基準に照らしてスコアリングできる。これにより、エージェントがプロジェクトを「見る」手段が与えられる。

コアコンセプト

コンセプト	機能
ドメインスキル	小さな自己完結型の Markdown ファイル（`SKILL.md`）で、1 つの Godot 機能（例：`godot‑characterbody‑2d`、`godot‑game‑loop‑waves`）を説明する。各ファイルには公式ドキュメントへの参照リンク、サンプルスクリプト、移行ノートが含まれる。
Godot‑master	すべての 99 個のドメインスキルを集約し、意思決定マトリクス、アンチパターンリスト、パフォーマンス予算、階層的なシグナルベースアーキテクチャ図を追加する「リードアーキテクト」スキル。新規プロジェクトや、全体的なプロジェクトガイドが必要なエージェントの最初の入り口。
エージェント最適設計（DIA ループ）	発見・インジェスト・適用ループは、エージェントが `skills_index.json` を検索し、適切な `SKILL.md` ファイルを読み、モデルのコンテキストを過剰に負荷せずに知識を適用する方法を示す。
インストール基準	各エージェント用のインストールフラグ（`-a cursor`、`-a claude-code` など）と期待されるディレクトリ構造（`.agents/skills/`、`~/.cursor/skills/` など）の表。
コンテキスト・ストームのガードレール	`--all` を使用しないよう明示的な警告。すべてのスキルを一度にインストールすると約 15 k トークンを消費し、「メタデータの洪水」が発生し、推論が遅くなる。

クイックスタートパス

パス	使用タイミング	コマンド（`skills` CLI 経由）
A – アーキテクト	新規プロジェクトの開始または既存プロジェクトの完全なレビューが必要な場合。	`npx skills add thedivergentai/gd-agentic-skills/skills/godot-master -g -a <agent> -y`
B – 専門家	単一の機能（例：2D 移動、インベントリ）のみが必要な場合。	`npx skills add thedivergentai/gd-agentic-skills/skills/godot-characterbody-2d -g -a <agent> -y`

インストール後、npx skills list -g -a <agent> を実行して確認し、ホストエージェントを再起動して新しいスキルファイルを読み込ませる。

注目すべき更新（最新 v0.0.11）

godot‑agent‑vision – エディタ GUI/アセットビューポートをキャプチャし、WebP として保存し、細かい基準（フォント重視、スロップ防止、アイデンティティ）に基づいて視覚出力をスコアリング。
クロスプラットフォームホスト CLI – Windows/macOS/Linux に対応する軽量ラッパー。リポジトリとエージェントを橋渡しする。.gdskills/ 以下に存在し、ゲーム内 Autoload ではない。
移行ステーション – 専用スキル（godot‑version‑migration）で、任意の古い Godot バージョンから 4.7 まで段階的にアップグレードするガイドを提供。各スキルごとの移行ノート付き。
参照ラティス – すべてのドメインスキルの末尾に、公式 Godot ドキュメントと関連スキルのキュレートされたリストが追加され、エージェントがスキルグラフから離れずに「より深く調査」できる。

対象読者

Godot プロジェクトの生成またはリファクタリングを行う AI コーディングエージェント（Claude Code、Cursor、Gemini‑CLI など）。
自分のエージェントに供給するトークン効率的で検証済みのリファレンスライブラリを必要とする人間の開発者。
プログラム的に照会可能な、構造的で最新の Godot 最適実践例を探している教育者／メンター。

制限事項と注意点

ライブラリは Godot とは外部にある。Godot プラグインや Autoload としてインストールされない。エージェントは Markdown ファイルを読み取り、提供されたスニペットを自ら挿入する必要がある。
skills CLI（Vercel‑Labs のツール）によるインストールに依存している。この CLI を使用しないユーザーは、「クローン / DIA パス」ワークフローに従う必要がある：skills_index.json を読み、エージェントのファイルツールで関連する SKILL.md ファイルを開く。
すべての 99 個のスキルを一度にインストールすることは推奨されない。大量のトークン予算を消費し、「コンテキスト・ストーム」を引き起こす可能性がある。推奨されるパターンは、単一の godot‑master オーガナイザーか、ターゲットドメインスキルの少数をインストールすること。
ビジョンスキルは現在、予算付き WebP 画像とスコアを出力するが、提供されたスコア基準を超えた本格的な画像分析は行わない。

まとめ

GD Agentic Skills は、AI コーディングエージェントが Godot 4.7+ で体系的かつ最適実践を優先して作業できるように設計された、目的特化型でトークン効率の良い知識ベースである。godot‑master スキルまたは選択的なドメインスキルをインストールすることで、エージェントはキュレートされたドキュメントリンク、プロダクション品質の GDScript スニペット、移行ガイド、さらには視覚的検証にアクセスできるが、モデルのコンテキストを過剰に負荷することなく。

クイックリファレンスリンク

完全なスキルインデックス: skills_index.json
Godot‑master スキル: skills/godot-master/SKILL.md
ビジョンスキル: skills/godot-agent-vision/SKILL.md
インストールガイド: 上記の ⚡ クイックスタート テーブルを参照。