ゲーム開発のAgent Skills：Claude Code・Codex・Cursorへの導入

ゲームのプロジェクトルートで npx skills add gamedev-skills/awesome-gamedev-agent-skills を実行し、gamedev-skills/awesome-gamedev-agent-skills のインストール対象に router を含め、使用するコーディングエージェントを選んでください。続いてrouterを明示的に呼び出し、大きな機能を依頼する前にGodotかUnityで小さな変更を確認します。全カタログをインストールしても、すべてのスキル本文がコンテキストに読み込まれるわけではありません。エージェントはまずメタデータからスキルを見つけ、必要になった時点で選んだ指示を読みます。

2026-10-26時点のリポジトリには、76個の専門スキルと、それとは別のrouterがあり、スキル定義は合計77個です。リポジトリのAbout欄にはまだ74と書かれています。実際に何が入るかは、現在のファイルとインストーラーのプレビューで確認してください。このパックはApache-2.0ライセンスで公開されています。

この構成は、すでにコーディングエージェントを使っていて、エンジン固有の指示を繰り返し利用したい開発者に向いています。パックが提供するのはコードや作業手順のガイドです。ゲームエディター、プロジェクト、利用可能なエージェントのアカウントまたはAPI設定は別途必要です。

プロジェクト単位でインストールする

まずはゲームのプロジェクト内にインストールし、追加されたファイルをゲーム側の変更と一緒に確認できるようにします。npmのメタデータによると、2026-10-26時点で公開されている skills CLIは1.7.4で、Node.js 22.20.0以降が必要です。リポジトリを取得するため、Gitも使える状態にしてください。

ゲームのプロジェクトルートでBashを開き、カタログをプレビューします。

node --version
git --version
npx skills add gamedev-skills/awesome-gamedev-agent-skills --list

router、godot-2d-movement、platformer、unity-scriptableobjects が一覧にあるか確認してください。--list は利用可能なスキルを表示するだけで、スキル自体はインストールしません。インストールを確定する前に、routerと利用予定のスキルの指示を読んでおきます。

パックの公式なインストール手順にあるコマンドを実行します。

npx skills add gamedev-skills/awesome-gamedev-agent-skills

この手順では、対話形式の選択画面でrouterと全カタログを対象にし、使用するエージェントを選び、範囲をProjectに設定します。-g を追加するのは、複数のプロジェクトで使うためにユーザー単位のインストールを意図的に選ぶ場合だけにしてください。

Codex向けに全カタログを明示的に選ぶ場合は、次のコマンドも使えます。

npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill '*' -a codex

別のクライアントを使う場合は、codex を claude-code または cursor に置き換えます。'*' の引用符は、Bashがワイルドカードを展開しないように残してください。CLIのリファレンスでは、すべてのスキルを選ぶ --skill '*' と、さらにすべてのエージェントを対象にする --all が区別されています。

インストール結果を確認します。

npx skills list

router と、選んだエンジンの動作確認に必要なスキルが表示されることを確かめてください。インストーラーが取得するのは公開されたスキルファイルです。モデルの認証設定はコーディング用クライアント側に残り、エージェントを動かすと通常どおりモデルの利用枠が消費されるか、API料金が発生します。

Claude Code・Codex・Cursorはどこからファイルを読むのか

エージェントが対応するディレクトリとCLIが選ぶ保存先は必ずしも一致しないため、実際のインストール先を確認してください。skills 1.7.4でプロジェクト内にインストールする場合、対応は次のとおりです。

エージェント	-a の後に指定する値	プロジェクト内のインストール先	チャットでrouterを明示的に呼び出す方法
Claude Code	claude-code	.claude/skills/	/router
Codex CLIまたはIDE拡張機能	codex	.agents/skills/	/skills から router を選ぶか、$router を指定する
Cursor Agent	cursor	.agents/skills/	/ を入力して router を選ぶ

この表の呼び出し操作は、Bashではなくエージェントのチャット内で行います。Cursorは手動インストール用の .cursor/skills/ にも対応しています。パックの簡潔なインストールページは対応ディレクトリの確認に使えますが、.cursor/skills/ が空でもCLIによる導入が失敗したとは限りません。

現在のインストーラーのエージェント設定では、CodexとCursorの両方が .agents/skills/ に割り当てられています。保存先が1つのディレクトリにまとまる場合は、そこにファイルがコピーされます。保存先の異なるクライアントを選んだ場合は、.agents/skills/ にある共通のコピーをシンボリックリンクで共有するか、別々のコピーを作成できます。常にリンクが作られると思い込まず、インストール時のサマリーを確認してください。

各スキルは <skills-directory>/<skill-name>/SKILL.md という形で配置されます。たとえばCodexの移動スキルは .agents/skills/godot-2d-movement/SKILL.md、Claude Codeでは .claude/skills/godot-2d-movement/SKILL.md です。手動インストールの説明に従い、スキルに references/、scripts/、assets/ が同梱されている場合は、それらも一緒に保持してください。

routerはすべてのスキルを読まずにどう選ぶのか

routerはエンジンと作業内容から必要な指示を選び、必要なときだけ読み込む仕組み自体は実行元のエージェントが提供します。Agent Skills仕様の概要では、名前と説明による検出、本文を読むことによる有効化、必要に応じた追加リソースの利用という段階が説明されています。

パックのrouterの指示は、この仕組みをゲーム開発に当てはめています。

1. プロジェクトから使用エンジンを1つ特定し、そのバージョンを読む。
2. エンジン、専門分野、ジャンル、作業手順に関係する最小限のスキルを選ぶ。
3. 選んだ本文を読み、同梱の参考資料は作業に必要な場合だけ開く。

Godotを見分ける主なファイルは project.godot です。Unityでは Assets/ と ProjectSettings/ProjectVersion.txt の組み合わせを使います。移動処理の依頼なら godot-2d-movement と platformer を選べます。その後にセーブ処理を依頼した場合は、無関係なエンジンのカタログを読むのではなく、データの保存に関する適切な指示へ切り替えるべきです。

router自体も、モデルが従う SKILL.md 形式の手順書です。読み込み回数の上限を強制する独立した実行プログラムではありません。また、routerだけをインストールしても、そこから参照される専門的な指示までは手に入りません。対象のスキルもインストールされ、エージェントが見つけられる必要があります。

メタデータもコンテキストを使います。読み込んだ指示、ツールの結果、再試行も利用量に含まれます。すでに多数のスキルがあり、スキル検出に使えるコンテキスト量について警告が出る場合は、--skill でrouterと必要な専門スキルだけを含む小さな構成にしてください。スキルの数だけを根拠に、特定の割合でトークンが節約できると考えることはできません。

エンジンの小さな作業で動作を確認する

指示が読み込まれたことと、エンジン上で期待する動作になったことの両方を確認します。ゲームのプロジェクトでエージェントの新しいセッションを開始し、上の表に従ってrouterを明示的に選んでから、以下のいずれかのプロンプトを使ってください。

クライアントがツールの実行内容を表示する場合は、スキルの有効化や実際のファイル読み込みを確認します。「スキルを読み込みました」という返答だけよりも、インストール済みの SKILL.md を正常に読めた記録のほうが確かな根拠になります。

Godot：空中での追加ジャンプを実装する

CharacterBody2D のプレイヤー、衝突判定用の形状、床がそろった、実行可能な既存のGodot 4シーンを使います。routerはこの依頼に godot-2d-movement と platformer を組み合わせる例を示しています。移動スキルが、エンジンに合ったコントローラーの実装方針を提供します。

このプロンプトでは、編集前にプロジェクト設定と実際のエディターバージョンを調べ、既存の操作方法を変えずにプレイヤーのコントローラーだけを変更するよう求めます。読み込んだrouterとスキルの実際のパス、変更したファイル、確認用のシーンと操作を報告させ、エージェントが実施した確認と自分で行う確認を分けます。

Use the installed router skill for this Godot project. Inspect project.godot
and the actual editor version before editing, and preserve that version.

Report the resolved paths of the router and selected SKILL.md files you
actually read. Resolve skill names through the installed skill locations.

Add one extra mid-air jump to the existing CharacterBody2D player.
Keep the change in the player controller and preserve the current controls.
A fresh jump press on the ground starts the first jump. One more fresh
press in the air starts the second. A third press before landing does
nothing. Holding the button must not repeatedly jump. Landing restores
both jumps.

List the changed files and give the exact scene and controls for checking
the result. Separate checks you ran from checks I must perform in Godot.

指定されたシーンを実行してください。ボタンを押し直す操作を2回行うと2回ジャンプし、空中で3回目に押しても新たなジャンプは発生せず、着地すると再び同じ操作ができるのが期待する結果です。ジャンプ中にボタンを押し続けても繰り返し発動しないことと、新しいスクリプトエラーや実行時エラーが出ていないことも確認します。

パックの移動スキルはGodot 4.7を基準にしていますが、エンジン検出の指示では既存プロジェクトのバージョンを維持するよう定めています。パックを導入したことだけを理由にプロジェクトを移行したり、別のリリースのAPIへ置き換えたりしないでください。

Unity：共有データと実行時の数量を分離する

既存のUnityプロジェクトに、後で破棄できる検証用シーンを用意します。この確認では unity-scriptableobjects を使い、データを利用する小さなコンポーネントには unity-csharp-scripting も適しています。インベントリシステム全体を依頼せずに、共有データに関するスキルの指示を確認するための例です。

ここでは ItemDefinition を CreateAssetMenu 付きのScriptableObjectとして作り、itemId、displayName、maxStack を共通の設定として持たせます。同じアセットを参照するスロットは別々のインスタンスにし、変化する数量だけを各スロットに保存します。検証を繰り返す際は毎回新しいスロットを作り、前回の実行状態が残らないようにします。

Unityでもエディターとパッケージのバージョンは維持し、実行できた確認とエディターで手動確認する項目を分けて報告させます。

Use the installed router skill for this Unity project. Read
ProjectSettings/ProjectVersion.txt and preserve the editor and package
versions. Report the resolved SKILL.md paths you actually read.

Create an ItemDefinition ScriptableObject with itemId, displayName,
and maxStack, using CreateAssetMenu. Use one example asset with
itemId "potion", displayName "Potion", and maxStack 10. Treat the asset
as read-only configuration during play.

Create two distinct runtime slot instances referencing that same asset.
Start their quantities at 2 and 5. Add one small probe component that
decrements only the first slot, then reports quantities 1 and 5,
confirms both slots reference the same asset, and checks that the
definition fields are unchanged. Start each probe run with fresh slots.

Keep the output to the data model and probe component. Give exact
asset-creation, component-attachment, Inspector-assignment, and Play-mode
steps. Distinguish checks you executed from checks I must perform.

生成されたAssetsメニューの項目からサンプルアセットを作り、空のGameObjectに検証コンポーネントを追加し、Inspectorでアセットを割り当ててPlayモードに入ります。期待する結果は、それぞれの数量が2と5から1と5になり、両方のスロットが同じ定義への参照を保持していることです。Playモードを終了した後も、アセットの内容は potion、Potion、10 のままになっている必要があります。

UnityのScriptableObjectのドキュメントは、利用側のオブジェクトが参照を通じて1つのアセットを共有できると説明しています。アセットそのものが変更不能なわけではありません。この例では、変化する数量を意図的に別々の実行時オブジェクトに置いています。両方の数量が同時に変わるなら、定義だけでなくスロットのオブジェクトまで誤って共有していないか確認してください。

routerや選んだスキルが見つからない場合はどうするか

インストール、スキルの検出、ファイルのパス解決を分けて確認してください。症状に応じて次の対応を選びます。

症状	確認事項と次の対応
スキル一覧が表示される前にプレビューが失敗する	実際のエラーを読み、使用中のNode.jsのバージョン、Gitの有無、npm/GitHubへのアクセスを確認します。問題のある前提条件を直してから --list を再実行します。
インストール済み一覧にエンジンのスキルはあるが router がない	インストールをやり直し、router を含めます。リポジトリの skills/ の中身だけを手動でコピーすると、独立した router/ ディレクトリが抜けます。
ファイルはあるがエージェントの選択肢に出ない	セッションが目的のプロジェクトで開かれていることと、各フォルダーに SKILL.md があることを確認します。クライアントの文書に記載されたパスを調べ、検出結果が更新されていなければセッションを再起動します。
skills/godot/ または skills/unity/ で始まるパスを開けない	スキル名から実際のインストール先を特定し、ファイルを正常に読めたことを確認してから編集します。
別のエンジンが選ばれる	ゲームの正しいサブディレクトリを開くか、対象のエンジンとプロジェクトを明示します。エージェントが示す判定材料とバージョンを確認してください。

パス解決には注意が必要です。routerは元のファイルを skills/<category>/<name>/SKILL.md と表記していますが、CLIのインストーラーは個々のスキルをそれぞれの名前のディレクトリとして配置します。元リポジトリからの相対パスをそのままたどると、インストール済みのスキルを見つけられない場合があります。これは確認すべきディレクトリ構成の違いであり、すべてのクライアントで失敗する証拠ではありません。

そのため、CodexやCursorに導入したGodotのスキルは、同梱の参考資料とともに .agents/skills/godot-2d-movement/SKILL.md に見つかることがあります。ゲーム内に元リポジトリと同じ構成のツリーをもう1つ作るのではなく、検出されたインストール先のパスを使ってください。

外部のスキルは再利用する前に内容を確認する

これらのファイルは、エージェントによる編集やコマンド実行に影響する指示としてレビューしてください。初めて使う前に、router、選択したスキルの本文、必要な参考資料、実行を求めるスクリプトや外部コマンドを読みます。依存関係のインストール、ダウンロード先、アップロード、データを削除するような操作が、自分の依頼した作業に合っているか確認してください。

--list のプレビューではスキルパックはインストールされませんが、npx はインストーラー自体を実行します。普段使っているコマンド承認の設定を保ち、インストール時のサマリーで既存のどのスキルが上書きされるかを確認してください。

更新を取り込む際は、ファイル冒頭のメタデータであるフロントマターも確認します。たとえばClaude Codeのallowed-tools の説明によると、このフィールドはツール利用を事前承認できますが、サンドボックスによる制限を設定する項目ではありません。フロントマターが少なくても、変更された指示や同梱コマンドはレビューしてください。

最初の変更は、差分を読んで確認できる小さな範囲に収めます。スキルを更新した後も、大きな機能の実装を任せる前に、対応するエンジンの動作確認を繰り返してください。