postgres-dba

A set of conventions for designing PostgreSQL databases and SQL schemas. It covers naming, keys, relationships, enums, generated columns, JSONB, migrations, and database functions.

In plain words
What is it for?
Use it when designing tables, foreign keys, many-to-many relationships, validation rules, migrations, or SQL functions in PostgreSQL.
Why use it?
It moves data-integrity rules into the database instead of relying only on application code. Consistent choices make future schema changes easier to manage.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/robconery/kolea/postgres-dba
Any agent
npx skills add robconery/kolea --skill postgres-dba
Clone the repo
git clone --depth 1 https://github.com/robconery/kolea

Made for: Claude Code, Codex.

Per session 162 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,799 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00162 $0.01799
Opus 5 $0.00081 $0.00899
Sonnet 5 $0.00032 $0.00360
Haiku 4.5 $0.00016 $0.00180

Measured yesterday against content hash 9e9995936871, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

postgres-dba scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to postgres-dba — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/skills/postgres-dba/SKILL.md · 137 lines

How it starts

The opening of the file, as written. The whole thing — 137 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PostgreSQL DBA — Opinionated Schema Design

The database is the system of record, not a dumb bucket behind an ORM. Model integrity in the schema, push set-based logic into functions, and let the application consume a clean, self-defending API. These conventions are defaults with teeth: deviating is allowed, but only deliberately and with a comment saying why.

🎯 Why: Design for Change

The goal of writing software is to be able to change it safely — and a schema is the hardest thing in any system to change. Consistent naming, surrogate keys, NOT NULL FKs, enums, and logic-in-functions exist so migrations stay mechanical: you add a column, you don't reshape the world. JSONB next to a relational spine lets the document side evolve without a migration. Every rule here optimizes for the next migration being boring.

This skill is about database design and SQL. For TypeScript/app-layer concerns use the language skills; this skill never defers integrity to the application.

How to use this skill

  1. Match the task to a rule below or in the decision guide.
  2. Open the matching references/*.md for the full rationale, the wrong way, the right way, and the explicit-override escape hatch.
  3. Copy the closest file from templates/ and adapt it — the templates already encode every convention here, so you start compliant.
  4. Apply the rule unless you can state, in a comment in the DDL, the specific reason it does not apply here. "It was easier" is not a reason.

The hard rules (non-negotiable defaults)

  1. Naming is snake_case, lowercase, unquoted, forever. Tables plural (orders), columns singular (shipped_at), no reserved words, no CamelCase, no quoted identifiers in the schema. If you ever need to double-quote an identifier in normal queries, the name is wrong. See references/naming.md.

  2. Every base table has id serial primary key. A synthetic key, always named id, is the row's identity. Natural keys get a UNIQUE constraint, never the primary key. Use bigserial/identity only when you have a concrete reason to expect >2.1B rows — and write that reason in a comment. See references/keys.md.

Read the full file on GitHub · 137 lines

Files

What ships with it

10 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 137 lines · 162 tokens per session scan A 9e9995936871

Subscribe to this mod's changes

postgres-dba is a skill published in the GitHub repository robconery/kolea (1 stars, last pushed 2d ago), licensed MIT. It adds 162 tokens to every session and 1,799 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to postgres-dba, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

supermemory

Supermemory is a state-of-the-art memory and context infrastructure for AI agents. Use this skill when building applications that need persistent memory, user personalization, long-term context retention, or semantic search across knowledge bases. It provides Memory API for learned user context, User Profiles for…

supermemoryai/supermemory · 81 tokens

moemail

Use when an AI agent needs a temporary/disposable email address — for receiving verification emails, testing email integrations, or any task requiring a temporary inbox via the moemail CLI.

beilunyang/moemail · 37 tokens

moemail

Use when working in this repository and an AI agent needs a temporary/disposable email address through the MoeMail CLI.

beilunyang/moemail · 26 tokens

create-saasmail-template

Write, validate, and create email templates for a saasmail instance — the full {{variable}} interpolation grammar, conditional/repeating {{#section}} rendering, HTML escaping, and the required-vs-optional send contract. Use this skill whenever the user is authoring or editing a saasmail email template, or asks…

choyiny/saasmail · 174 tokens

saasmail-onboarding

Interactive setup wizard for deploying your own saasmail instance to Cloudflare. Use this skill when the user wants to set up saasmail, deploy it, configure Cloudflare resources, or get started with the project. Also trigger when the user says "onboarding", "setup", "deploy saasmail", "get started", or asks how to…

choyiny/saasmail · 84 tokens

use-saasmail

Send transactional emails and enroll recipients in drip sequences through a deployed saasmail instance's HTTP API. Use this skill whenever the user wants to programmatically send mail, fire off a template, kick off an onboarding/drip sequence, manage recipient enrollment, or integrate their app with their self-hosted…

choyiny/saasmail · 112 tokens