インストール
npx skills add supabase/agent-skills誰向けか
このガイドは、すでに、またはこれから AI Agent で Supabase 開発をする人向けです。公式には、開発者が AI agents で Supabase を使うための Agent Skills として書かれています。
着手前に、このマシンで npx が動くこと、そして現在のディレクトリがスキルファイルを書き込みたいプロジェクトであることを確認してください。ページは 18+ AI agents と互換だと明記し、Claude Code、GitHub Copilot、Cursor、Cline、その他多数を含みます。これは互換の説明であり排他リストではなく、製品一覧から言語範囲を逆算してもいけません。
インストール後、スキルは自動で利用可能になり、Agent は関連タスクを検出したときに使います。初回は、データベースを変える、関数を公開する、ストレージを変えるタスクを意図的に起動しないでください。
3 分で初回試行を完了する
ページが示す推奨インストールコマンドだけを使います。
npx skills add supabase/agent-skills
前提条件：このマシンに npx があり、現在の作業ディレクトリが対象プロジェクトのルートであること。インストール先は現在のプロジェクトです。ページに出ていないマーケットコマンドや手作業コピーのパスに書き換えないでください。
副作用の確認点：このコマンドはスキルファイルを現在のプロジェクトに書き込みます。ディレクトリが違えば、まず止まってください。インストール自体は Supabase プロジェクトを自動では変えません。ただしその後、Agent が関連タスクを検出するとこれらのスキルを使う可能性があります。ディレクトリが正しいことを確認してから実行してください。
成功の合図：コマンドが正常終了し、プロジェクトにスキルファイルが現れることです。その後の確認は一度だけです。互換のある Agent で読み取り専用の質問をし、たとえば現在の Database または Auth の接続をどう理解すべきかを尋ね、インストール済みスキルに沿って答えるかを見てください。テーブル作成、Edge Functions のデプロイ、Storage の変更、Cron/Queues への操作はしないでください。Agent が書き込みを実行しようとしたら、確認点で止まってください。
使用事例
事例 1：公式スキルを現在のプロジェクトに入れる。確認済みのプロジェクトルートで npx skills add supabase/agent-skills を実行する。根拠がカバーするのはこのコマンドと、開発者が AI agents で Supabase を使う助けになることです。完了基準はインストール成功とスキルファイルの出現までです。出ていない更新やアンインストールコマンドを足さないでください。
事例 2：インストール後に読み取り専用の製品確認をする。ページはスキルが任意の Supabase 製品をカバーすると明記しています：Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues。またインストール後は自動で利用可能で、Agent は関連タスクを検出したときに使います。抜粋に具体的なスラッシュコマンドはないので、初回は製品のひとつについて読み取り専用の説明だけを尋ねます。たとえば既存の Database または Auth 設定をどう理解すべきかです。観察できる成功の合図は、Agent がインストール済みスキルに沿って答えることであり、クラウド資源をすでに変えたことではありません。Cron、Queues、Storage などの書き込み面は製品一覧にありますが、初回に操作すべきという意味ではありません。
使用上の境界
主インストール経路は npx skills add supabase/agent-skills だけです。列挙された Agent は唯一のサポート範囲ではありません。関連タスクが検出されるとスキルは自動で有効になるので、オンラインデータを変えるタスクは質問から避けてください。製品一覧は認可リストではありません。アンインストール、具体的なスキルファイル名、製品ごとのコマンドは抜粋になく、書いていない内容を安全結論にしてはいけません。