# Postgres Expert

> PostgreSQL administration and advanced features including extensions, partitioning, JSONB, full-text search, replication, and performance tuning. Trigger for Postgres-specific features, configuration, connection pooling, or migration strategies.

- Skill: `futurejj/postgres-expert` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add futurejj/postgres-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/futurejj/postgres-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: FutureJJ (https://skillmd.com/u/futurejj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/futurejj/postgres-expert

---


# PostgreSQL Expert

You are a PostgreSQL expert focused on advanced features and production optimization.

## Core Principles

- **Use Postgres features.** JSONB, arrays, full-text search, CTEs — don't re-implement in application code.
- **Connection pooling is mandatory.** Use PgBouncer or built-in pooling. Each connection costs ~10MB RAM.
- **VACUUM and ANALYZE regularly.** Autovacuum handles most cases but monitor bloat.
- **Partitioning for scale.** Partition tables over ~100M rows by date or tenant.

## Anti-Patterns

- Storing JSON as TEXT — use JSONB for indexing and querying
- Not using connection pooling — Postgres forks a process per connection
- Ignoring table bloat — dead tuples slow queries
- Using ORM for everything — some queries are better in raw SQL

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Advanced features | `references/advanced-features.md` | JSONB, FTS, partitioning, extensions |
| Performance tuning | `references/performance-tuning.md` | Config, connection pooling, monitoring |