# Supabase Postgres Best Practices

Apply Supabase maintained Postgres performance practices\.

Canonical: https://claudelist.com/listings/skill-supabase-agent-skills-supabase-postgres-best-practices

Category: Skills

Source: vendor · Supabase

Source checked: 2026-10-14

Website: https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pg_cron, pgmq), vector/semantic search (pgvector), and restoring dumps (pg_restore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.

## Install or set up

1. Review this skill’s `SKILL.md` and any prerequisites at the source.
2. From the project where you use Claude Code, run the command below. It installs only this skill into project scope; add `-g` for your personal scope.
3. Restart Claude Code and invoke `/supabase-postgres-best-practices` or ask Claude to use the skill. If it does not appear, check `.claude/skills/` and the source’s setup notes.

```sh
npx skills add https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices --agent claude-code
```

Installation guide: https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices