安裝
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 準備執行寫入，先停在確認點。
使用案例
案例一：把官方技能裝進目前專案。在已確認的專案根目錄執行 npx skills add supabase/agent-skills。證據涵蓋的是這條命令，以及它幫助開發者用 AI agents 使用 Supabase。完成標準止於安裝成功、技能檔案出現。不要補寫未出現的更新或解除安裝命令。
案例二：安裝後做一個唯讀的產品核對。頁面寫明技能涵蓋任一 Supabase 產品：Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues；並且安裝後自動可用，Agent 在偵測到相關任務時使用。摘錄沒有給出具體斜線命令，所以第一次只問 Agent 針對其中一項產品的唯讀說明，例如 Database 或 Auth 的現有設定該如何理解。可觀察的成功訊號是 Agent 明顯按已安裝技能回答，而不是它已經改了雲端資源。Cron、Queues、Storage 等寫入面存在於產品名單中，但不等於第一次就要操作它們。
使用邊界
主安裝路徑只有 npx skills add supabase/agent-skills。列出的 Agent 不是唯一支援範圍。技能會在相關任務被偵測到時自動啟用，因此提問要避開會改線上資料的任務。產品名單不是授權清單。解除安裝、具體技能檔名和每個產品的命令未出現在摘錄中，未寫到的內容不能當成安全結論。