design-postgres-tables

Schema design decisions made explicitly: data types, key strategy, JSONB versus columns, and when partitioning earns its complexity.

Score 0(?)VerifiedCodeby TigerData (Timescale)SourceDocs
Verified for:

Install

$ npx skills add timescale/pg-aiguide --skill design-postgres-tables

Best for

Designing a new schema, or reviewing one before it accumulates the data that makes changing it expensive.

Not ideal for

Applying a migration to an existing live table — reach for the migration skill instead, which covers the locking behaviour this one does not.

About this skill

Use when designing PostgreSQL tables and schemas — choosing data types, primary and foreign keys, B-tree versus GIN indexes, JSONB versus columns, normalization level, partitioning strategy, and row-level security. Trigger on new table design, data modelling, or reviewing an existing schema for correctness and performance.

Schema designPostgreSQLJSONB

Score breakdown

Score breakdown

rubric 1.0
Install count
0/20
Provenance
12.8/15
GitHub stars
9.2/15
Recency
6/10
Compatibility
2/10
Documentation depth
10/10
Install ergonomics
10/10
License
5/5
Verification freshness
0.5/5

Composite 0–100 score derived from 9 verifiable signals. See the rubric →

PlanetScale's schema branching and index-aware queries, packaged for agents.

SchemaMigrationsMySQL
Code
Medium4 min

Supabase done right. RLS policies, edge functions, realtime, auth — in idiomatic patterns.

PostgresRLSRealtime
Code
Medium4 min

Prisma migrations and queries by the book. Index-aware, migration-safe, type-correct.

PrismaTypeScriptMigrations
Code
Medium3 min

Ranked #7 in Databases

Publish the ranking in your README. The badge reads the live score, so it updates when the ranking does.

design-postgres-tables — ranked #7 in Databases on Top Agent Skills
Markdown
[![design-postgres-tables — ranked #7 in Databases on Top Agent Skills](https://top-agent-skills.com/badge/postgres-table-design.svg)](https://top-agent-skills.com/skill/postgres-table-design)
HTML
<a href="https://top-agent-skills.com/skill/postgres-table-design"><img src="https://top-agent-skills.com/badge/postgres-table-design.svg" alt="design-postgres-tables — ranked #7 in Databases on Top Agent Skills"></a>

Skill FAQ

About design-postgres-tables

What is the design-postgres-tables skill?

Use when designing PostgreSQL tables and schemas — choosing data types, primary and foreign keys, B-tree versus GIN indexes, JSONB versus columns, normalization level, partitioning strategy, and row-level security. Trigger on new table design, data modelling, or reviewing an existing schema for correctness and performance.

Which agents does design-postgres-tables work with?

Claude Code.

How do I install design-postgres-tables?

Run `npx skills add timescale/pg-aiguide --skill design-postgres-tables` for Claude Code. See the install panel for per-agent commands.

Is design-postgres-tables free to use?

Yes — design-postgres-tables is open source (Apache-2.0).

Who maintains design-postgres-tables?

design-postgres-tables is published by TigerData (Timescale) and was last updated on 2026-06-26.

What is design-postgres-tables best for?

Designing a new schema, or reviewing one before it accumulates the data that makes changing it expensive.