# Supabase Agent Skills

> 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.

- Skill: `akillness/supabase-agent-skills` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add akillness/supabase-agent-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akillness/supabase-agent-skills/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: akillness (https://skillmd.com/u/akillness)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/akillness/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