{"$schema":"https://top-agent-skills.com/schemas/skill.v1.json","name":"design-postgres-tables","slug":"postgres-table-design","canonical":"https://top-agent-skills.com/skill/postgres-table-design","description":"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.","tagline":"Schema design decisions made explicitly: data types, key strategy, JSONB versus columns, and when partitioning earns its complexity.","bestFor":"Designing a new schema, or reviewing one before it accumulates the data that makes changing it expensive.","notIdealFor":"Applying a migration to an existing live table — reach for the migration skill instead, which covers the locking behaviour this one does not.","publisher":{"name":"TigerData (Timescale)","url":"https://www.tigerdata.com","tier":"verified-org"},"license":"Apache-2.0","isOpenSource":true,"surfaces":["claude-code"],"compatibility":["claude-code"],"capabilityLevel":"read-only","setup":{"time":"1 min","complexity":"Low"},"install":[{"agent":"claude-code","command":"npx skills add timescale/pg-aiguide --skill design-postgres-tables","manual":null,"followUp":null}],"taxonomy":{"primaryCategories":["databases-schemas"],"verticalCategories":["engineering"],"tags":["Schema design","PostgreSQL","JSONB"],"filters":["verified-org","open-source","one-command-install","read-only","agent-friendly","works-with-claude-code"]},"links":{"github":"https://github.com/timescale/pg-aiguide/tree/main/skills/design-postgres-tables","docs":"https://github.com/timescale/pg-aiguide/blob/main/skills/design-postgres-tables/SKILL.md","website":null},"_meta":{"score":{"value":55,"rubric":"1.0","inputs":{"installCount":0,"provenance":12.8,"githubStars":9.2,"recency":6,"compatibility":2,"documentation":10,"installErgonomics":10,"license":5,"verification":0.5}},"stats":{"installCount":null,"githubStars":1814,"lastUpdated":"2026-06-26","verifiedAt":null}}}