Supabase Agent Skills

Overview

GitHubGitHub

Supabase Agent Skills 是一组遵循 [Agent Skills](https://agentskills.io/) 开放标准的技能包，旨在帮助开发者在使用 AI 代理时更准确、高效地操作 Supabase。 ## 它是什么 Agent Skills 是由指令文件、脚本和参考资料组成的文件夹。AI 代理在检测到相关任务时可以自动发现并使用这些技能。该仓库兼容 18 种以上的 AI 代理工具，包括 Claude Code、GitHub Copilot、Cursor、Cline 等。 ## 包含的技能 - **supabase**：涵盖 Supabase 全部产品与集成的综合开发技能。适用于 Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues 等产品，以及 supabase-js、@supabase/ssr 等客户端库在 Next.js、React、SvelteKit、Astro、Remix 中的 SSR 集成。也可用于排查认证问题（登录、登出、会话、JWT、Cookie、RLS 等）、使用 Supabase CLI 或 MCP server，以及处理 schema 变更、迁移、安全审计和 Postgres 扩展（pg_graphql、pg_cron、pg_vector）。 - **supabase-postgres-best-practices**：来自 Supabase 的 Postgres 性能优化指南，按影响程度分为 8 个类别并设定优先级。适用于编写 SQL 查询、设计 schema、实现索引与查询优化、排查数据库性能问题、配置连接池与扩缩容，以及处理 Row-Level Security (RLS)。覆盖的类别包括 Query Performance（Critical）、Connection Management（Critical）、Schema Design（High）、Concurrency & Locking（Medium-High）、Security & RLS（Critical）、Data Access Patterns（Medium）、Monitoring & Diagnostics（Low-Medium）、Advanced Features（Low）。 ## 技能结构 每个技能遵循 Agent Skills Open Standard，包含必需的 `SKILL.md` 清单文件（带有 frontmatter 元数据）和可选的 `references/` 参考文档目录。 ## 适合谁 适合在日常开发中使用 AI 代理辅助操作 Supabase 的开发者，尤其是需要编写 Postgres 查询、管理认证流程或进行数据库性能优化的场景。

Q&A

如何安装所有技能？AI-generated

运行命令 npx skills add supabase/agent-skills 即可安装全部技能。

如何只安装某个特定技能？AI-generated

使用 --skill 参数指定技能名，例如 npx skills add supabase/agent-skills --skill supabase-postgres-best-practices。

如何在 Claude Code 中作为插件安装？AI-generated

先运行 claude plugin marketplace add supabase/agent-skills 添加市场，再运行 claude plugin install supabase@supabase-agent-skills 安装对应插件。

安装后如何使用这些技能？AI-generated

技能安装后自动可用。当 AI 代理检测到相关任务时会自行调用，无需额外配置。

supabase-postgres-best-practices 技能覆盖哪些类别？AI-generated

覆盖 8 个类别：Query Performance、Connection Management、Schema Design、Concurrency & Locking、Security & RLS、Data Access Patterns、Monitoring & Diagnostics、Advanced Features，并按影响程度标注了优先级。

这些技能兼容哪些 AI 代理？AI-generated

兼容 18 种以上的 AI 代理，包括 Claude Code、GitHub Copilot、Cursor、Cline 等。