supabase-agent-skills

supabase-agent-skills

オープンソースの supabase/agent-skills パッケージを使用して、AI エージェントで Supabase ワークフローを有効にするタスクで、このスキルを使用します。

使用する場面

• Claude／Codex／Copilot／Cursor 形式のエージェント向けに Supabase スキルパックをインストールする
• 一括インストールではなく、特定の Supabase スキルだけを選択する
• 生成されたコードに頼る前に、スキルのインストールが成功したことを確認する
• スキルを読み込めない場合は、直接 SQL／CLI で確認する

手順

ステップ 1：前提条件を確認する

• Node.js と npm/npx が利用できることを確認します。
• 追加のスキルをインストールする前に、プロジェクトで実際に Supabase／Postgres を使用していることを確認します。

node -v
npm -v

ステップ 2：スキルパッケージをインストールする

次のいずれかの方法を使用します。

# Install all Supabase skills
npx skills add supabase/agent-skills

# Install specific skill only
npx skills add supabase/agent-skills --skill supabase
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

ステップ 3：Claude プラグインを使用する場合

Claude プラグインのワークフローを使用する場合：

claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills

ステップ 4：確認とスモークテスト

• インストール済みスキルの一覧に Supabase の項目が含まれていることを確認します。
• 範囲を限定したタスク（スキーマのイントロスペクションまたはクエリのレビュー）を 1 つ実行し、出力の品質を確認します。
• 結果が不十分な場合は、直接コマンドを実行して SQL を調査します。

ステップ 5：フォールバック戦略

エージェントがスキルを読み込めない場合：

• Supabase CLI と SQL を直接使用するワークフローに切り替えます。
• マイグレーション／レビューの手順を明示し、エージェントの暗黙の前提に頼らないようにします。

ガードレール

• 明示的な確認なしに、破壊的な SQL／マイグレーションを実行しないでください。
• まず読み取り専用での確認を優先します（SELECT、スキーマのイントロスペクション、利用可能な場合はドライラン）。
• 認証情報は環境変数またはシークレットマネージャーで管理し、リポジトリ内のファイルにトークンをハードコードしないでください。

根拠

• ページを直接取得：https://github.com/supabase/agent-skills
• ページを直接取得：https://supabase.com/docs/guides/getting-started/ai-skills