Supabase Agent Skills
为使用AI助手进行Supabase开发的开发者提供技能包，提升准确性和效率。
- Star 数
- ★ 2.9k
- 最近更新
- 16 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 43/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者需要在Next.js项目中集成Supabase Auth并处理登录、会话等问题时，使用supabase技能快速获取指导。
- 不适合
- 不使用 Supabase 或 Postgres 的团队
- 无法安装 Node.js/npx 的开发者
- 需要完全离线、不依赖任何云服务的团队
这个 Agent 能做什么，适合哪些场景？
Supabase Agent Skills 是一个技能包仓库，包含开发者在AI助手中使用Supabase所需的指令、脚本和资源。这些技能遵循Agent Skills开放标准，兼容Claude Code、GitHub Copilot、Cursor等18种以上AI助手。仓库目前提供两个技能：supabase（涵盖所有Supabase产品和集成）和supabase-postgres-best-practices（Postgres性能优化指南，覆盖8个类别）。安装简单，可通过npx命令安装全部或特定技能，也支持作为Claude Code插件安装。该仓库的发布流程包含.well-known发现机制，便于在supabase.com上分发技能。
该仓库提供可被AI代理发现和使用的技能文件夹，每个技能包含SKILL.md清单文件和可选的references/参考文件。'supabase'技能涵盖Supabase的所有产品（数据库、认证、边缘函数、实时、存储、向量、定时任务、队列），以及客户端库和SSR集成，用于故障排查和CLI/MCP服务器使用。'supabase-postgres-best-practices'技能提供Postgres性能优化指南，按影响优先级分类，涵盖查询性能、连接管理、模式设计、并发与锁、安全与RLS、数据访问模式、监控与诊断以及高级特性。用户可通过npx skills add命令或Claude插件市场安装这些技能。安装后，AI代理在检测到相关任务时会自动使用这些技能，例如优化查询或审查模式。
- 开发者需要在Next.js项目中集成Supabase Auth并处理登录、会话等问题时，使用supabase技能快速获取指导。
- 数据库管理员需要优化Postgres查询性能，使用supabase-postgres-best-practices技能获取索引和查询优化建议。
- 使用Claude Code的开发者希望通过插件方式安装Supabase技能，以便在编码时自动获得Supabase相关帮助。
- 团队需要审查现有数据库模式的安全性，使用技能中的安全与RLS类别进行审计。
- 开发者使用Supabase CLI或MCP服务器进行模式变更和迁移时，借助技能减少错误。
如何安装或部署这个 Agent？
运行 npx skills add supabase/agent-skills 安装所有技能，或使用 npx skills add supabase/agent-skills --skill supabase 安装特定技能。此外，可通过以下命令作为Claude Code插件安装：claude plugin marketplace add supabase/agent-skills 然后 claude plugin install supabase@supabase-agent-skills。
如何使用这个 Agent？
安装后，AI代理将自动在相关任务中使用技能。例如，您可以向代理提问“优化此Postgres查询”或“审查我的模式是否有性能问题”，代理将加载技能提供的指导来帮助您。
这个 Agent 有哪些优点和局限？
- 覆盖Supabase全产品线，从数据库到认证、存储等，提供一站式指导。
- Postgres最佳实践按影响优先级分类，帮助用户优先处理关键问题。
- 兼容18种以上主流AI代理，安装灵活，支持npx和Claude插件。
- 技能内容主要针对Supabase构建的应用，对于其他数据库或框架的适用性有限。
- 安装和配置需要Node.js和npx环境，可能对非Node用户有门槛。
- 部分高级功能（如Postgres扩展）可能需要更深入的Supabase知识，初学者可能难以充分利用。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Supabase Agent Skills 当前 | 43 · 缺口较多 | 命令行工具免费 | ★ 2.9k | 16 天前 | TypeScript | ChatGPT · Claude Code |
| Agent Toolkit | 74 · 存在缺口 | 命令行工具免费 | ★ 19 | 今天 | V | ChatGPT · Codex · Claude Code |
| Rulesync | 69 · 存在缺口 | 命令行工具免费 | ★ 1.5k | 今天 | TypeScript | Codex · Claude Code |
| Agentic Plugin Marketplace | 66 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 41k | 1 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库包含安装脚本和发布工作流，但未提供权限最小化、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的具体实现或说明。因此所有信任标准得分为0。
自洽性：README、package.json 和测试文件在技能名称和安装方式上保持一致，得2分。依赖可用性：依赖在 package.json 中列出，但未提供锁定文件或完整性校验，得2分。失败消息：测试捕获错误输出，但未提供面向用户的失败消息设计，得1分。
受众和场景：README 描述了目标受众和使用场景，得2分。能力边界：技能描述明确了使用时机，得2分。触发精度：技能描述提供了使用条件，得2分。环境适配：支持多种代理和安装方式，得2分。
信息架构：README 清晰组织技能列表和结构，得2分。安装说明：提供了多种安装方式，得2分。命名稳定性：技能名称固定，得2分。示例和FAQ：提供了示例，但无FAQ，得2分。已知限制：未明确列出，得1分。许可证：MIT 许可证，得2分。版本和变更日志：有版本号但无变更日志，得2分。维护责任：有发布工作流，得2分。
输出可用性：技能提供指令和参考，得2分。边际价值：提供官方最佳实践，得2分。成本效益：安装简单，得2分。
声明可追溯性：README 中的声明未提供来源，得1分。跨来源佐证：无独立来源，得1分。事实与推断分离：未明确区分，得1分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 未提供权限最小化、用户确认、数据流透明等安全机制，安装脚本可能执行任意代码。
- 依赖未锁定，存在供应链风险。
- 发布工作流使用 GitHub App token，但未说明权限范围。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
[0.1.9](https://github.com/supabase/agent-skills/compare/v0.1.8...v0.1.9) (2026-09-24) Bug Fixes * supabase: recommend scoped personal access tokens for the Management API, CLI, and MCP ([#604](https://github.com/supabase/agent-skills/issues/604)) ([551274e](https://github.com/supabase/agent-skills/commit/551274ed2fe97c8fea1325f7ceb05803a542f8df))在 GitHub 查看 ↗ -
发布说明摘录
[0.1.8](https://github.com/supabase/agent-skills/compare/v0.1.7...v0.1.8) (2026-08-12) Features * supabase: add debugging workflows to the supabase skill ([#112](https://github.com/supabase/agent-skills/issues/112)) ([3a4f0ce](https://github.com/supabase/agent-skills/commit/3a4f0ce0782e0cbdcf187c362e8d15d9e324462b))在 GitHub 查看 ↗ -
发布说明摘录
[0.1.7](https://github.com/supabase/agent-skills/compare/v0.1.6...v0.1.7) (2026-07-30) Bug Fixes * supabase-postgres-best-practices: make skill description trigger-rich ([#194](https://github.com/supabase/agent-skills/issues/194)) ([3291216](https://github.com/supabase/agent-skills/commit/32912161e2732c3e5001c6811a76c1f8308ed0da))在 GitHub 查看 ↗