Supabase が公式にメンテナンスしている Postgres ルールライブラリです。エージェントが SQL を書く際、テーブル作成や列変更、マイグレーション記述、RLS ポリシー設定、インデックス追加を行う場合、またはクエリの遅延、接続枯渇、ロック、テーブル膨張を調査する際にまず読み込んでください。影響度に応じて 8 種類のルールに分類されており、各ルールには誤った SQL と正しい SQL の対照例が示されています。
skills.sh インストール数 468744（+1162 / 24時間）
セキュリティ監査：未実施
- まだスキャンされていません
理由
- 8 種類のルールは優先度順に並んでいます。クエリパフォーマンス、接続管理、セキュリティと RLS は CRITICAL（重要）としてマークされ、その後にテーブルスキーマ設計、並行処理とロック、データアクセスパターン、監視と診断、高度な機能が続きます。ルールファイルは references/ ディレクトリ配下に query-、conn-、security- などのプレフィックスを付けて配置されています
- トリガー範囲は広く設定されており、1つの列の変更や1クエリの記述だけでも読み込みが要求されます。また、pg_cron、pgmq キュー、pgvector ベクトル検索、pg_restore インポートもカバーしています
- 各ルールには理由、誤った SQL と正しい SQL の例、必要に応じて EXPLAIN 出力が含まれており、Supabase 固有の説明が付記される場合もあります。作者は Supabase に限定せず、どこで実行されている Postgres でも利用可能だと述べています
- MIT ライセンス、バージョン 1.1.1；skills.sh では 24 時間でインストール数 1162、累計 468744（これは注目度を示すに過ぎません）
使い方
- インストールコマンドは監査合格後に表示されます。README には Claude Code プラグインとしての方法も記載されています：claude plugin marketplace add supabase/agent-skills、続いて claude plugin install postgres-best-practices@supabase-agent-skills を実行します
- Supabase アカウントやサービスは不要です。これは純粋なテキストベースのルールであり、エージェントが必要に応じて references/ 配下の個別ルールファイルを読み込みます
リスク
- 今回の監査では未実施のため、固定で C ランクとなり、インストールコマンドは表示されません。SKILL.md はテキストと参考リンクのみで構成されており、スクリプトやネットワークリクエストはありません。skills.sh 上の3つの第三者監査はいずれも Pass です
- 今回は SKILL.md の概要表のみを確認し、references/ 配下の具体的なルールは一つずつ読んでいません。トリガー範囲が広いため、Postgres に触れる操作であればすべて読み込まれ、コンテキストを消費します
- ルールは Supabase 由来であり、一部の推奨事項（接続プール、RLS の書き方）には Supabase プラットフォームの慣習が含まれています。セルフホスト型の Postgres を利用する場合は、独自に判断する必要があります