Skip to content
TakoAPI
Back to skills

postgres-perf

by kjaylee

Coding Agents & IDEs
—Not yet rated
Your rating

Brief

PostgreSQL performance optimization and best practices.

Description

What This Skill Does

A reference guide for PostgreSQL query optimization, schema design, connection management, and Row Level Security. Covers indexing strategies, N+1 query patterns, and concurrency best practices. Based on Supabase postgres-best-practices.

Combines query tuning, schema decisions, and connection pooling guidance in one place rather than spread across separate Postgres and Supabase docs.

When to Use It

  • Diagnosing slow queries with EXPLAIN ANALYZE
  • Adding partial indexes for filtered queries
  • Replacing N+1 queries with JOINs
  • Configuring pgBouncer for serverless environments
  • Writing RLS policies without hurting performance

Example Workflow

INPUT

User asks: why is my orders query slow on a 2M row table?

AGENT
  1. 1

    Run EXPLAIN ANALYZE on the slow query to read the execution plan

  2. 2

    Identify Seq Scan on customer_email column

  3. 3

    Generate CREATE INDEX idx_orders_email ON orders(customer_email)

  4. 4

    Re-run EXPLAIN ANALYZE to confirm Index Scan is used

  5. 5

    Check if SELECT * can be narrowed to required columns only

OUTPUT

Index created, query switches from Seq Scan to Index Scan, execution time drops significantly

Installation

clawhub install kjaylee/postgres-perf

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links