Supabase Agent Skills

一套旨在帮助开发者使用 AI Agent 处理 Supabase 相关任务的技能（Agent Skills）。这些 Agent Skills 由一系列指令、脚本和资源组成，Claude Code、Cursor、GitHub Copilot 等 AI Agent 可以通过发现并利用它们，从而更准确、高效地执行任务。

本仓库中的技能遵循 Agent Skills 标准格式。

安装

npx skills add supabase/agent-skills

Claude Code 插件

你也可以将本仓库中的技能作为 Claude Code 插件安装：

/plugin marketplace add supabase/agent-skills
/plugin install postgres-best-practices@supabase-agent-skills

可用技能

supabase-postgres-best-practices

来自 Supabase 的 Postgres 性能优化指南。包含涵盖 8 个类别、按影响程度排序的参考资料。

适用场景：

• 编写 SQL 查询或设计数据库 Schema
• 实现索引或进行查询优化
• 排查数据库性能问题
• 配置连接池或进行扩容
• 处理行级安全性 (RLS)

涵盖类别：

• 查询性能 (Critical)
• 连接管理 (Critical)
• Schema 设计 (High)
• 并发与锁定 (Medium-High)
• 安全性与 RLS (Medium-High)
• 数据访问模式 (Medium)
• 监控与诊断 (Low-Medium)
• 高级功能 (Low)

使用方法

安装完成后，这些技能将自动生效。当检测到相关任务时，AI Agent 会自动调用它们。

示例：

Optimize this Postgres query

Review my schema for performance issues

Help me add proper indexes to this table

技能结构

每个技能均遵循 Agent Skills 开放标准：

• SKILL.md - 必需的技能清单文件，包含 frontmatter（名称、描述、元数据）
• AGENTS.md - 已编译的参考文档（自动生成）
• references/ - 独立的参考文件目录