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
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/supabase-agent-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/supabase-agent-skills/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a codex2Manually: put the files in place
.agents/skills/supabase-agent-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a cursor2Manually: put the files in place
.cursor/skills/supabase-agent-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills .agent-skills/supabase-agent-skills/SKILL.md2Manually: put the files in place
.github/skills/supabase-agent-skills/SKILL.md1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/supabase-agent-skillsManually: put the files in place
.devin/skills/supabase-agent-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill supabase-agent-skills -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → 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