AIエージェントスキル
Promete では、Claude Code・Codex・Cursor・GitHub Copilot などの AI エージェント向けに、Agent Skill（エージェントスキル）を提供しています。
エージェントスキルとは？
Section titled “エージェントスキルとは？”エージェントスキルは、AI エージェントに特定の分野の知識や作業手順を教えるためのパッケージです。インストールしておくと、エージェントは必要になったときに自動でスキルを読み込みます。
AI エージェントは、Promete のような比較的新しいライブラリについて、正確な知識を持っていないことがあります。存在しない API を使ったり、古いバージョンの書き方をしたりしがちです。スキルをインストールすると、エージェントはこのドキュメントの内容を参照しながらコードを書くので、こうした間違いが減ります。
提供しているスキル
Section titled “提供しているスキル”| スキル | 内容 |
|---|---|
promete | Promete の API と使い方。このドキュメントの「入門編」から「エンジンを拡張する」までのページを収録しています |
promete-v2-migration | Promete v1 で作ったプロジェクトを v2 に移行するためのスキル。詳しくは v1 → v2 移行ガイド を参照してください |
このページでは、promete スキルの使い方を説明します。
インストール
Section titled “インストール”お使いのエージェントに合わせて、インストール方法を選んでください。
-
Claude Code を起動し、Promete のマーケットプレイスを追加します。
/plugin marketplace add prometeapp/Promete -
prometeプラグインをインストールします。/plugin install promete@promete -
プラグインの詳細画面が表示されるので、画面の指示に従ってインストールします。
Codex・Cursor・GitHub Copilot・Gemini CLI などでは、skills コマンドでインストールできます。Node.js が必要です。
ゲームのプロジェクトのフォルダで、次のコマンドを実行してください。
npx skills add prometeapp/Promete --skill prometeインストールするエージェントを聞かれたら、お使いのエージェントを選んでください。すべてのプロジェクトで使いたい場合は、-g を付けて実行します。
npx skills add prometeapp/Promete --skill promete -gインストール後は、特別な操作は必要ありません。Promete を使ったプロジェクトで作業を頼むと、エージェントが自動でスキルを読み込みます。
たとえば、次のように依頼できます。
- 「Promete で、矢印キーでキャラクターを動かすシーンを作って」
- 「タイトル画面からゲーム画面に切り替える処理を追加して」
- 「BGM をループ再生して、ポーズ中は一時停止したい」
- 「このスプライトをマウスの方向に向けたい」
スキルの内容は、このドキュメントの更新に合わせて新しくなります。
次のコマンドで、マーケットプレイスとスキルを最新の状態にします。
/plugin marketplace update promete/plugin の Marketplaces タブで promete を選び、Enable auto-update を選ぶと、以降は自動で更新されるようになります。
次のコマンドで、スキルを最新の状態にします。-g を付けてインストールした場合は、こちらにも -g を付けてください。
npx skills update prometeアンインストール
Section titled “アンインストール”/plugin uninstall promete@prometenpx skills remove promete-g を付けてインストールした場合は、--global を付けて実行してください。
npx skills remove --global promete- スキルは Promete v2 を対象にしています。v1 のプロジェクトでは、先に
promete-v2-migrationスキルを使って v2 へ移行してください - エージェントが書いたコードは、必ず実際に動かして確認してください。スキルはエージェントの間違いを減らしますが、なくすものではありません