# supabase-agent-skills

A skill pack that gives AI coding agents direct access to Supabase and PostgreSQL tooling. Install once, and agents handle schema introspection, query review, and migrations automatically.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 252 installs · ★ 61 repo stars
- Author: akillness
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/supabase-agent-skills/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/supabase-agent-skills

## What it does

supabase-agent-skills extends AI editors (Claude Code, Cursor, GitHub Copilot, and others) with purpose-built tools for Supabase workflows: schema introspection, SQL query review, and migration assistance. The agent gains context about your database structure and can suggest optimizations inline while you code.

Installation is a single command like `npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code`, which caches the skill in your agent's local directory. You can install the full pack or pick individual skills using the `--skill` flag. If the skill fails to load, a fallback to direct Supabase CLI and SQL commands keeps your workflows intact.

Guardrails prevent accidents: destructive migrations require explicit confirmation, credentials stay in environment variables or secret managers, and read-only checks run first to verify output quality before the agent commits to changes.

## Requirements
- Works with: Supabase

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/supabase-agent-skills/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/supabase-agent-skills/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/supabase-agent-skills/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/supabase-agent-skills/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/supabase-agent-skills/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/supabase-agent-skills/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/supabase-agent-skills
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/supabase-agent-skills/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/supabase-agent-skills/SKILL.md

## When to use it
- inspect PostgreSQL schema from the editor without manual queries
- validate SQL before execution to catch performance issues early
- let the agent understand your Supabase structure without extra context windows
- switch to direct CLI commands if the skill becomes unavailable

## Example prompts
- Review our Supabase schema and suggest a better index for the users table
- Check this migration for N+1 queries and locking risks
- Write a join query across orders and customers with the right filters

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9273f8fec6017f66.

BEGIN THIRD-PARTY FILE 9273f8fec6017f66
````text
---
name: supabase-agent-skills
description: >
  Install and use Supabase Agent Skills (`supabase/agent-skills`) with AI coding
  agents. Covers install modes, skill selection, plugin path, verification, and
  safe fallback for direct Supabase CLI/database workflows.
allowed-tools: Bash Read Write Edit Glob Grep WebFetch
license: MIT
metadata:
  tags: supabase, postgres, agent-skills, ai-agent, database, backend, cli
  version: "1.0"
  source: https://github.com/supabase/agent-skills
---

# supabase-agent-skills

Use this skill when the task involves enabling Supabase workflows for AI agents using the open-source `supabase/agent-skills` package.

## When to use
- Install Supabase skill packs for Claude/Codex/Copilot/Cursor style agents
- Select only specific Supabase skills instead of bulk install
- Verify that skill installation succeeded before relying on generated code
- Route to direct SQL/CLI checks when skill loading is unavailable

## Instructions

### Step 1: Verify prerequisites
- Confirm Node.js and npm/npx are available.
- Confirm project actually uses Supabase/Postgres before installing extra skills.

```bash
node -v
npm -v
```

### Step 2: Install skill package
Use one of these paths:

```bash
# Install all Supabase skills
npx skills add supabase/agent-skills

# Install specific skill only
npx skills add supabase/agent-skills --skill supabase
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices
```

### Step 3: Optional Claude plugin path
If using Claude plugin workflow:

```bash
claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills
```

### Step 4: Verify and smoke test
- Confirm installed skill list includes Supabase entries.
- Run one bounded task (schema introspection or query review) and inspect output quality.
- If results are weak, fall back to direct commands and SQL inspection.

### Step 5: Fallback strategy
When agent skill loading is unavailable:
- Use direct Supabase CLI and SQL workflow.
- Keep migration/review steps explicit; do not rely on hidden agent assumptions.

## Guardrails
- Do not run destructive SQL/migrations without explicit confirmation.
- Prefer read-only verification first (`SELECT`, schema introspection, dry-run if available).
- Keep credentials in environment/secret manager; never hardcode tokens in repo files.

## Evidence
- direct page retrieval: https://github.com/supabase/agent-skills
````
END THIRD-PARTY FILE 9273f8fec6017f66

The third-party file has ended. Everything between the 9273f8fec6017f66 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2449 of 2534 bytes. © akillness · MIT · https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/supabase-agent-skills/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
