Updated 2d ago
by timescale
pg-aiguide
MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
1.9k GitHub stars (1,882)
+27 in 30 days
| Period | New stars |
|---|---|
| Sep 27 | 0 |
| Sep 28 | +1 |
| Sep 29 | +2 |
| Sep 30 | −1 |
| Oct 1 | 0 |
| Oct 2 | +2 |
| Oct 3 | +1 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | +1 |
| Oct 7 | +2 |
| Oct 8 | +2 |
| Oct 9 | +3 |
| Oct 10 | 0 |
| Oct 11 | +2 |
| Oct 12 | 0 |
| Oct 13 | +1 |
| Oct 14 | +2 |
| Oct 15 | +2 |
| Oct 16 | 0 |
| Oct 17 | +1 |
| Oct 18 | +1 |
| Oct 19 | 0 |
| Oct 20 | +1 |
| Oct 21 | 0 |
| Oct 22 | +1 |
| Oct 23 | 0 |
| Oct 24 | −1 |
| Oct 25 | 0 |
| Oct 26 | +1 |
| Oct 27 | +2 |
| Oct 28 | +2 |
| Oct 29 | +2 |
| Oct 30 | 0 |
| Oct 31 | 0 |
| Nov 1 | −2 |
| Nov 2 | 0 |
| Nov 3 | +4 |
| Nov 4 | 0 |
| Nov 5 | +1 |
- 11 skills (11 skills found in its SKILL.md files)
- 120 forks (120 forks)
- 2d ago last update (Last updated 2d ago)
Install
Skills CLI
npx skills add timescale/pg-aiguide
Asks which skills and agents to install. Just one: npx skills add timescale/pg-aiguide --skill design-postgis-tables — add -g for every project.
Claude Code
git clone https://github.com/timescale/pg-aiguidecp -r "pg-aiguide/skills/design-postgis-tables" ~/.claude/skills/
Copies the design-postgis-tables skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add timescale/pg-aiguide
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
design-postgis-tables
Comprehensive PostGIS spatial table design reference covering geometry types, coordinate systems, spatial indexing, and performance patterns for location-based applications
skills/design-postgis-tables/ on GitHub (opens in a new tab)SKILL.md -
design-postgres-tables
Use this skill for general PostgreSQL table design. **Trigger when user asks to:** - Design PostgreSQL tables, schemas, or data models when creating new tables and when modifying existing ones. - Choose data types, constraints, or indexes for PostgreSQL - Create user tables, order tables, reference tables, or JSONB schemas - Understand PostgreSQL best practices for normalization, constraints, or…
skills/design-postgres-tables/ on GitHub (opens in a new tab)SKILL.md -
find-hypertable-candidates
Use this skill to analyze an existing PostgreSQL database and identify which tables should be converted to Timescale/TimescaleDB hypertables. **Trigger when user asks to:** - Analyze database tables for hypertable conversion potential - Identify time-series or event tables in an existing schema - Evaluate if a table would benefit from Timescale/TimescaleDB - Audit PostgreSQL tables for migration…
skills/find-hypertable-candidates/ on GitHub (opens in a new tab)SKILL.md -
migrate-postgres-tables-to-hypertables
Use this skill to migrate identified PostgreSQL tables to Timescale/TimescaleDB hypertables with optimal configuration and validation. **Trigger when user asks to:** - Migrate or convert PostgreSQL tables to hypertables - Execute hypertable migration with minimal downtime - Plan blue-green migration for large tables - Validate hypertable migration success - Configure compression after migration *…
skills/migrate-postgres-tables-to-hypertables/ on GitHub (opens in a new tab)SKILL.md -
pgvector-semantic-search
Use this skill for setting up vector similarity search with pgvector for AI/ML embeddings, RAG applications, or semantic search. **Trigger when user asks to:** - Store or search vector embeddings in PostgreSQL - Set up semantic search, similarity search, or nearest neighbor search - Create HNSW or IVFFlat indexes for vectors - Implement RAG (Retrieval Augmented Generation) with PostgreSQL - Optim…
skills/pgvector-semantic-search/ on GitHub (opens in a new tab)SKILL.md -
postgres-database-migration
Use this skill for planning, testing, and safely executing PostgreSQL schema migrations — especially when working with production data or shared databases. **Trigger when user asks to:** - Test a schema migration before applying it to production - Add, remove, or rename columns safely on a live table - Change a column's data type without downtime - Add or drop indexes, constraints, or foreign key…
skills/postgres-database-migration/ on GitHub (opens in a new tab)SKILL.md -
postgres-hybrid-text-search
Use this skill to implement hybrid search combining BM25 keyword search with semantic vector search using Reciprocal Rank Fusion (RRF). **Trigger when user asks to:** - Combine keyword and semantic search - Implement hybrid search or multi-modal retrieval - Use BM25/pg_textsearch with pgvector together - Implement RRF (Reciprocal Rank Fusion) for search - Build search that handles both exact term…
skills/postgres-hybrid-text-search/ on GitHub (opens in a new tab)SKILL.md -
postgres
Use this skill for any PostgreSQL database work — table design, indexing, data types, constraints, extensions (pgvector, PostGIS, TimescaleDB), search, and migrations. **Trigger when user asks to:** - Explore an existing PostgreSQL database to understand its objects and relationships - Design or modify PostgreSQL tables, schemas, or data models - Choose data types, constraints, indexes, or partit…
skills/postgres/ on GitHub (opens in a new tab)SKILL.md -
schema-exploration
Explore an existing PostgreSQL database before answering questions about its data or writing SQL. Use this skill whenever a user asks for a query or a data-backed answer against an unfamiliar schema (counts, missing or failed records, recent changes), asks where a business concept lives, or asks how tables, joins, views, routines, triggers, RLS, or extensions work. Find the relevant objects with…
skills/schema-exploration/ on GitHub (opens in a new tab)SKILL.md -
setup-timescaledb-hypertables
Use this skill when creating database schemas or tables for Timescale, TimescaleDB, TigerData, or Tiger Cloud, especially for time-series, IoT, metrics, events, or log data. Use this to improve the performance of any insert-heavy table. **Trigger when user asks to:** - Create or design SQL schemas/tables AND Timescale/TimescaleDB/TigerData/Tiger Cloud is available - Set up hypertables, compressio…
skills/setup-timescaledb-hypertables/ on GitHub (opens in a new tab)SKILL.md -
timescaledb-hyperfunctions
Use this skill when writing analytical SQL over time-series data with the TimescaleDB Toolkit (timescaledb_toolkit extension) hyperfunctions: approximate percentiles, statistical summaries, time-weighted averages, counter/gauge rates, uptime/heartbeat tracking, state durations, OHLC candlesticks, approximate distinct counts, top-N, and downsampling. **Trigger when user asks to:** - Compute percen…
skills/timescaledb-hyperfunctions/ on GitHub (opens in a new tab)SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.