mcpField
P
postgres

postgres

github.com/pageai-proData & databases33566 installsUpdated 18w ago
Repository

About postgres

A reference skill for PlanetScale Postgres users, covering PostgreSQL design, tuning, operations, and PlanetScale-specific topics. Its guides span schema design through CLI usage.

Key features

  1. 01Schema, indexing, and partitioning guides
  2. 02Query patterns and optimization
  3. 03Transactions, MVCC, and VACUUM
  4. 04Replication, backup, and recovery
  5. 05PlanetScale connections and CLI guidance

Use cases

  1. 01Plan table schemas and indexes
  2. 02Investigate slow queries or connection issues
  3. 03Manage replication, backups, and recovery

MCP support

The references include PlanetScale Insights guidance that mentions an MCP server.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pageai-pro/ralph-loop --skill postgres

After installing, type/postgresin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
backup-recovery.md
index-optimization.md
indexing.md
memory-management-ops.md
monitoring.md
mvcc-transactions.md
mvcc-vacuum.md
optimization-checklist.md
partitioning.md
process-architecture.md
ps-cli-api-insights.md
ps-cli-commands.md
ps-connection-pooling.md
ps-connections.md
ps-extensions.md
ps-insights.md
query-patterns.md
replication.md
schema-design.md
storage-layout.md
wal-operations.md

Details

From the project README

PlanetScale Postgres

Generic Postgres

TopicReferenceUse for
Schema Designreferences/schema-design.mdTables, primary keys, data types, foreign keys
Indexingreferences/indexing.mdIndex types, composite indexes, performance
Index Optimizationreferences/index-optimization.mdUnused/duplicate index queries, index audit
Partitioningreferences/partitioning.mdLarge tables, time-series, data retention
Query Patternsreferences/query-patterns.mdSQL anti-patterns, JOINs, pagination, batch queries
Optimization Checklistreferences/optimization-checklist.mdPre-optimization audit, cleanup, readiness checks
MVCC and VACUUMreferences/mvcc-vacuum.mdDead tuples, long transactions, xid wraparound prevention

Operations and Architecture

TopicReferenceUse for
Process Architecturereferences/process-architecture.mdMulti-process model, connection pooling, auxiliary processes
Memory Architecturereferences/memory-management-ops.mdShared/private memory layout, OS page cache, OOM prevention
MVCC Transactionsreferences/mvcc-transactions.mdIsolation levels, XID wraparound, serialization errors
WAL and Checkpointsreferences/wal-operations.mdWAL internals, checkpoint tuning, durability, crash recovery
Replicationreferences/replication.mdStreaming replication, slots, sync commit, failover
Storage Layoutreferences/storage-layout.mdPGDATA structure, TOAST, fillfactor, tablespaces, disk mgmt
Monitoringreferences/monitoring.mdpg_stat views, logging, pg_stat_statements, host metrics
Backup and Recoveryreferences/backup-recovery.mdpg_dump, pg_basebackup, PITR, WAL archiving, backup tools

PlanetScale-Specific

TopicReferenceUse for
Connection Poolingreferences/ps-connection-pooling.mdPgBouncer, pool sizing, pooled vs direct
Extensionsreferences/ps-extensions.mdSupported extensions, compatibility
Connectionsreferences/ps-connections.mdConnection troubleshooting, drivers, SSL
Insightsreferences/ps-insights.mdSlow queries, MCP server, pscale CLI
CLI Commandsreferences/ps-cli-commands.mdpscale CLI reference, branches, deploy requests, auth
CLI API Insightsreferences/ps-cli-api-insights.mdQuery insights via pscale api, schema analysis

Comments

Markdown supported