Agent skill · Supabase

Supabase skill for Claude Code, Codex and Cursor

Covers Supabase products and client libraries: database, auth, edge functions, storage, realtime.

Officialname: supabase★ 2.9k (repo)pushed 2026-10-02MITSKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, declarative...

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Supabase

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add supabase/agent-skills --skill supabase

This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (supabase, postgres-best-practices), or copy only this skill into ~/.claude/skills. docs

/plugin marketplace add supabase/agent-skills
/plugin install <plugin>@supabase-agent-skills

# or only this skill:
npx skills add supabase/agent-skills --skill supabase -a claude-code

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/supabase/agent-skills.git /tmp/supabase-src
cp -r /tmp/supabase-src/skills/supabase ./supabase
zip -r supabase.zip supabase

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add supabase/agent-skills --skill supabase -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install supabase/agent-skills supabase

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add supabase/agent-skills --skill supabase -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/supabase/agent-skills.git --path skills/supabase

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add supabase/agent-skills --skill supabase -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add supabase/agent-skills --skill supabase -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

What's in the SKILL.md

9 sections

Core Principles
Supabase CLI
Supabase MCP Server
Supabase Documentation
Making and Committing Schema Changes
Option A: Declarative schemas
Option B: Imperative migrations
Debugging
Reference Guides

Bundled files

CHANGELOG.md
assets/feedback-issue-template.md
references/skill-feedback.md

Loaded only when the instructions point to them.

Facts

Skill name: supabase
Publisher: Supabase (official)
Repo: supabase/agent-skills
License: MIT
Version: 0.1.2
SKILL.md size: 1,783 words, 148 lines
Bundled files: 3, 3 docs
Repo stars: 2.9k (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Supabase MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from supabase/agent-skills

Postgres Best Practices (Supabase): Postgres rules for schema design, indexes, RLS and migrations, usable on any Postgres host.

Related backend & databases skills

Optimize EF Core Queries · Microsoft (.NET)
Durable Objects · Cloudflare
Firebase Basics · Firebase (Google)
Cloud Firestore · Firebase (Google)
Sanity Best Practices · Sanity
MongoDB Schema Design · MongoDB
Neon Postgres · Neon
Neon Branches · Neon

FAQ

What does the supabase skill do?+

Covers Supabase products and client libraries: database, auth, edge functions, storage, realtime. In its own SKILL.md, Supabase describes it as: "Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions,..."

How do I install the supabase skill?+

Run npx skills add supabase/agent-skills --skill supabase and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/supabase/SKILL.md; in Codex and Cursor in .agents/skills/supabase/.

Does Supabase work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Supabase?+

Supabase, the company or project behind it, in the supabase/agent-skills repo on GitHub, last pushed 2026-10-02. License: MIT.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers