
Postgres best practices for your agent: table design, indexes, pgvector and hybrid search, PostGIS and TimescaleDB hypertables.
Pack · 9 skillsby timescale
4 images
About
pg-aiguide Skills are Tiger Data's curated PostgreSQL best practices, packaged as Agent Skills so your coding agent writes better Postgres: tables with the right types, constraints and indexes, plus guidance for pgvector, PostGIS and TimescaleDB. Tiger Data, the maker of TimescaleDB, publishes them in its open-source pg-aiguide repository. What the skills teach your agent - postgres: one entry point that loads the right guide for the task, including safe schema migrations on production databases - design-postgres-tables: data types, constraints, indexes, JSONB patterns and partitioning - schema-exploration: read-only exploration of an existing database through pg_catalog, asking before it looks at any rows or statistics - design-postgis-tables: geometry or geography, coordinate systems (SRIDs) and spatial indexes - pgvector-semantic-search: storing embeddings, HNSW indexes, quantization and filtered vector search - postgres-hybrid-text-search: BM25 keyword search combined with vector search using Reciprocal Rank Fusion - setup-timescaledb-hypertables: hypertables, compression, retention policies and continuous aggregates - find-hypertable-candidates and migrate-postgres-tables-to-hypertables: score existing tables for conversion, then migrate and validate them How it installs - Add them all with npx skills add timescale/pg-aiguide, or one at a time, such as --skill postgres or --skill schema-exploration. - The skills are instructions and SQL patterns. They don't connect to a database on their own; your agent uses whatever database access you've already given it. Good to know - Tiger Data also runs a public pg-aiguide MCP server at https://mcp.tigerdata.com/docs for semantic search across the PostgreSQL, TimescaleDB and PostGIS manuals. - The README documents Claude Code, Cursor, Codex and Gemini CLI. - Open source under the Apache 2.0 license.
Once it’s added
“Create a Postgres table schema for storing usernames and unique email addresses.”
“Design a Postgres schema for our factory sensors: temperature, humidity and pressure readings per device over time.”
“Which tables in this database should become TimescaleDB hypertables?”
“Set up pgvector semantic search over our documents table.”
“Combine keyword and semantic search for our product catalog.”
“Where does this database keep failed payments? Explore the schema before writing the query.”
Before you add it
Reads only
Explores an existing schema with read-only catalog queries · Asks before inspecting rows or data-derived statistics
Makes changes · your agent can ask first
Writes table definitions, indexes and constraints in your project · Plans and runs hypertable migrations when you ask, through the database access you give your agent
Pack · 9 skills, each with its own page
From people who use it
Step by step
Nothing new reaches your agent until a person has looked at it.
No reviews yet. Used pg-aiguide Skills? Say how it went.
Write a reviewRuns on your machine.
Runs on your machine.
Runs on your machine.
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.copilot/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.copilot/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.copilot/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.copilot/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.copilot/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.copilot/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.copilot/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.copilot/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.copilot/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.cursor/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.cursor/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.cursor/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.cursor/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.cursor/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.cursor/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.cursor/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.cursor/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.cursor/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.claude/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.claude/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.claude/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.claude/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.claude/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.claude/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.claude/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.claude/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.claude/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.agents/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.agents/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.agents/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.agents/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.agents/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.agents/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.agents/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.agents/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.agents/skills/setup-timescaledb-hypertables
Runs on your machine.
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.gemini/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.gemini/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.gemini/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.gemini/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.gemini/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.gemini/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.gemini/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.gemini/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.gemini/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables .agents/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables .agents/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates .agents/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables .agents/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search .agents/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres .agents/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search .agents/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration .agents/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables .agents/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.openclaw/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.openclaw/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.openclaw/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.openclaw/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.openclaw/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.openclaw/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.openclaw/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.openclaw/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.openclaw/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.config/opencode/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.config/opencode/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.config/opencode/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.config/opencode/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.config/opencode/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.config/opencode/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.config/opencode/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.config/opencode/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.config/opencode/skills/setup-timescaledb-hypertables
Runs on your machine.
npx -y degit timescale/pg-aiguide/skills/design-postgis-tables ~/.hermes/skills/design-postgis-tables npx -y degit timescale/pg-aiguide/skills/design-postgres-tables ~/.hermes/skills/design-postgres-tables npx -y degit timescale/pg-aiguide/skills/find-hypertable-candidates ~/.hermes/skills/find-hypertable-candidates npx -y degit timescale/pg-aiguide/skills/migrate-postgres-tables-to-hypertables ~/.hermes/skills/migrate-postgres-tables-to-hypertables npx -y degit timescale/pg-aiguide/skills/pgvector-semantic-search ~/.hermes/skills/pgvector-semantic-search npx -y degit timescale/pg-aiguide/skills/postgres ~/.hermes/skills/postgres npx -y degit timescale/pg-aiguide/skills/postgres-hybrid-text-search ~/.hermes/skills/postgres-hybrid-text-search npx -y degit timescale/pg-aiguide/skills/schema-exploration ~/.hermes/skills/schema-exploration npx -y degit timescale/pg-aiguide/skills/setup-timescaledb-hypertables ~/.hermes/skills/setup-timescaledb-hypertables
Scanned and passed · checked 11 h ago
Skills people install alongside pg-aiguide Skills.
Scanned on every change, and again when our rules improve.
Tell us and a person on the trust team will look at it. Or email [email protected].
Nobody has shared how they use pg-aiguide Skills yet.
Security scan
Passed
Safe to install in every agent it supports. Runs in your agent, as instructions.
Turns SQL CREATE TABLE statements or DBML into a clean Chen-model ER diagram, then lays it out and exports SVG, PNG, draw.io or HTML.
Redis' own skills for your agent: data structures, connections, Search and vectors, semantic caching, clustering, security and monitoring.
Teaches your agent to read a SQL Server execution plan and say what is actually slow and why, without the usual wrong conclusions.