技能介绍
Supabase Agent Skills 是 Supabase 官方提供的一组技能包，帮助开发者在使用 AI agent 时更准确、更高效地使用 Supabase。它由「指令、脚本和资源」组成，兼容 18+ 种 AI agent，包括 Claude Code、GitHub Copilot、Cursor、Cline 等。
它解决的是「agent 写 Supabase / Postgres 代码凭印象猜」的问题：把 Supabase 官方的最佳实践和产品知识沉淀进 agent，让 agent 在处理数据库、鉴权、性能优化等任务时按官方姿势输出，而不是给出过时或想当然的写法。
组合内包含两个可安装的子 Skill：一个是全面的 Supabase 开发技能，一个是 Postgres 性能优化指南。安装后技能会自动对 AI agent 可用，当 agent 检测到相关任务时会自行调用，无需手动激活。
适用场景
supabase 子技能适用于：
- 使用任何 Supabase 产品（Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues）
- 在 Next.js、React、SvelteKit、Astro、Remix 中使用客户端库和 SSR 集成（supabase-js、@supabase/ssr）
- 排查 Auth 问题（登录、登出、会话、JWT、Cookie、getSession、getUser、getClaims、RLS）
- 使用 Supabase CLI 或 MCP 服务器
- 处理 schema 变更、迁移、安全审计或 Postgres 扩展（pg_graphql、pg_cron、pg_vector）
supabase-postgres-best-practices 子技能适用于：
- 编写 SQL 查询或设计 schema
- 实现索引或查询优化
- 审核数据库性能问题
- 配置连接池或扩展
- 处理行级安全（RLS）
核心能力
- supabase：全面的 Supabase 开发技能，涵盖所有 Supabase 产品及集成，包括 Auth、客户端库、CLI、MCP、schema 变更、迁移、安全审计和 Postgres 扩展的指导。
- supabase-postgres-best-practices：来自 Supabase 的 Postgres 性能优化指南，涵盖 8 个类别，按影响力优先级排列：查询性能（关键）、连接管理（关键）、Schema 设计（高）、并发与锁（中高）、安全与 RLS（关键）、数据访问模式（中）、监控与诊断（低中）、高级功能（低）。
选型说明（两个子技能怎么选）
- 涉及 Supabase 产品、客户端库、Auth、CLI 或 schema 管理的任务，使用 supabase 技能。
- 涉及 Postgres 性能优化、查询调优、索引设计、连接池和 RLS 审查的任务，使用 supabase-postgres-best-practices 技能。
注意事项
- 不需要额外 API 密钥、账号或配置（除 AI agent 本身外）。
- 兼容 18+ 种 AI agent，包括 Claude Code、GitHub Copilot、Cursor、Cline 等。
- 安装后技能自动生效，agent 检测到相关任务时自动使用，无需手动激活。
效果预览
工作方式
安装后，技能会自动对您的 AI agent 可用。当 agent 检测到相关任务时，会使用技能中的指令和参考文档来更准确、高效地完成任务。您只需用自然语言描述任务即可，不需要记住技能名，也不需要手动切换。
你需要提供
与 Supabase 或 Postgres 相关的自然语言请求或问题。例如：
- 优化这条 Postgres 查询
- 检查我的 schema 是否存在性能问题
- 帮我用 Next.js 设置 Supabase Auth
- 帮我为这张表添加合适的索引
你会获得
Agent 根据技能指导产生准确的结果，例如：
- 优化后的 SQL 查询
- Schema 设计建议
- 索引建议
- Auth 配置步骤
- Auth 或性能问题的排查指导
使用示例
安装后直接用自然语言提问即可：
优化这条 Postgres 查询检查我的 schema 是否存在性能问题帮我用 Next.js 设置 Supabase Auth帮我为这张表添加合适的索引页面上的「试试这样做」示例：
帮我审查这个数据库架构的性能问题，并提供优化建议。如何使用 Next.js 配置 Supabase 身份验证？请为我的 Postgres 表添加合适的索引以优化查询性能。
