安装
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 不是唯一支持范围。技能会在相关任务被检测到时自动启用，因此提问要避开会改线上数据的任务。产品名单不是授权清单。卸载、具体技能文件名和每个产品的命令未出现在摘录中，未写到的内容不能当成安全结论。