Setup & Installation
openclaw skills install @kjaylee/postgres-perf
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install postgres-perf
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: why is my orders query slow on a 2M row table?
AGENT
- 1Run EXPLAIN ANALYZE on the slow query to read the execution plan
- 2Identify Seq Scan on customer_email column
- 3Generate CREATE INDEX idx_orders_email ON orders(customer_email)
- 4Re-run EXPLAIN ANALYZE to confirm Index Scan is used
- 5Check if SELECT * can be narrowed to required columns only
OUTPUT
Index created, query switches from Seq Scan to Index Scan, execution time drops significantly