Skip to main content
skill CX Codex

supabase-agent-skills — Claude Code skill: Supabase integration

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.

MIT 252 installs ★ 61 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code
Open on GitHub

What supabase-agent-skills 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.

What it helps with

  • 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 for the agent

  • 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

How to install supabase-agent-skills

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code

2Manually: put the files in place

~/.claude/skills/supabase-agent-skills/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/supabase-agent-skills/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about supabase-agent-skills

How do I install supabase-agent-skills in Claude Code?

Run npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-code. The skill installs into ~/.claude/skills/supabase-agent-skills/.

What does supabase-agent-skills do?

It equips AI agents with built-in tools for Supabase: schema inspection, SQL validation, migration helpers, and query optimization tips.

What if the skill fails to load?

Fall back to direct Supabase CLI commands and raw SQL. Check that Node.js and npm are available, then retry the install. All database operations work through standard tools.

Source text

SKILL.md · MIT
---
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
- direct page retrieval: https://supabase.com/docs/guides/getting-started/ai-skills

© akillness · MIT · akillness/jeo-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set99

The whole set →
react-best-practices react-best-practices — a skill that audits React and Next.js performance: it traces request waterfalls, extra bundle JS, server-client boundary mistakes and wasted rerenders. CX Codex +1 401installs rtk Installs and wires RTK (Rust Token Killer) so shell command output reaches your agent in compact form. Useful when logs and diffs eat the context window. CX Codex +1 740installs graphify Drives the graphify CLI to create and inspect code knowledge graphs. Useful for tracing structural links across a repo and scoping diffs before code reviews. CX Codex +1 699installs data-analysis data-analysis — a skill that walks the agent through dataset analysis: quality checks first, then the right method, then findings with caveats. Useful when you have an export and need an answer, not just code. CX Codex +1 601installs web-accessibility Classifies web accessibility failures, prioritizes keyboard and screen reader fixes over ARIA patching, and outputs structured remediation packets. CX Codex +1 558installs code-refactoring The code-refactoring skill turns a refactoring request into a behavior-aware plan with clear guardrails, reviewable slices, and a defined next step. CX Codex +1 552installs technical-writing technical-writing is a Claude Code skill for drafting technical documents for engineers and operators. It handles requests for ADRs, runbooks, migration plans, and internal guides. CX Codex +1 546installs video-production video-production plans programmable and automated video pipelines, routing workflows to Remotion compositions or cloud render APIs. CX Codex +1 511installs

More in the catalog

Project sponsors

Companies that keep this analytics open