Supabase query performance
Created by CodeCraft LLCDiagnose and fix Postgres performance in Supabase projects
Product and technology names are trademarks of their respective owners, used only to identify what this skill covers. CodeCraft LLC is not affiliated with or endorsed by them.
by Jace (@jamick)v1.3.0 · updated 2026-10-18Report copyright infringement
Description
Diagnose and fix Postgres performance in Supabase projects — finding slow queries (Query Performance report, pg_stat_statements, Performance Advisor, index_advisor), reading EXPLAIN (ANALYZE, BUFFERS) plans, choosing indexes (B-tree composite order, partial, covering, GIN for JSONB/arrays/full-text, trigram for ILIKE, BRIN for append-only time series), making RLS policies fast, connection management (Supavisor transaction vs session pooling, prepared statements, serverless clients), pagination and counts in supabase-js/PostgREST, N+1 and embedded selects, batch writes and upserts, lock contention and short transactions, statement timeouts, vacuum/analyze and bloat, Realtime scale, and partitioning. Use whenever a Supabase/Postgres query or page is slow, the database CPU or connections are high, the user sees timeouts or "too many connections", reviews query/index changes, or prepares for scale.
Included with all-access
$9.00 value as a single download
AiSkillz is in preview: browse the catalogue now - skill downloads and subscriptions open soon.
All skills are included with the all-access subscription
Changelog
v1.3.0Oct 18, 2026Latest
Added
references/explain-analyze-guide.mdnow covers Heap Fetches on index-only scans, lossy bitmap heap scans, extended statistics (CREATE STATISTICS) for correlated columns, per-column statistics targets, and capturing plans of slow queries withauto_explain.
Fixed
- The EXPLAIN guide is now listed in SKILL.md and the README, so agents know when to read it.
v1.2.0Oct 16, 2026
Added
references/postgres-indexing.md: a general PostgreSQL indexing guide (composite order, covering, partial, expression, GIN/trigram, maintenance) - merged from the formersql-indexingskill.
v1.1.0Oct 3, 2026
Changed
- Checked against the official documentation (October 2026).
- Expanded connection guidance: direct (IPv6), shared pooler session vs transaction mode (IPv4), dedicated pooler on paid plans, pool size 1 and prepared statements off for serverless.
v1.0.1Oct 3, 2026
Changed
- Added a trademark notice to the README.
v1.0.0Oct 2, 2026
Added
- First release.