neondatabase / postgres-skills
✓ Official★ 16A skill package that teaches your agent 2 capabilities — every one documented and browsable below, no GitHub required · by neondatabase.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Best practices and guidelines for working with Postgres. Covers schema design, indexing strategies, query optimization, migrations, and common pitfalls. Use…
3 files — installable on its own
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's…
9 files — installable on its own
Postgres Skills
A collection of Agent Skills for Postgres, curated from practitioners with years of real-world experience building and scaling applications on Postgres.
Installation
npx skills add neondatabase/postgres-skillsWhat are Agent Skills?
Skills are folders of instructions, scripts, and resources that agents can discover and use to perform tasks more accurately. Once installed, skills are automatically invoked when the agent detects relevant tasks.
Each skill starts with a SKILL.md file that serves as the entry point, allowing agents to progressively discover more detail as needed.
Available Skills
Postgres Best Practices
skills/postgres-best-practices
Best practices and guidelines for working with Postgres. Covers schema design, indexing, query optimization, and common pitfalls.
About postgres-skills
Goal
Give every AI engineer instant access to the collected experience of a staff engineer who has seen what works and what fails in production Postgres. Once installed, these skills guide your agent toward proven patterns and away from common mistakes.
Guiding Principles
- Vendor-agnostic. The skills are for Postgres users, regardless of which provider or deployment they use.
- Curated contributors. Content comes from well-known, credible Postgres practitioners with demonstrated real-world expertise.
- Paid commissions. Contributors are compensated for their time to keep the quality bar high.
Contributors
- Stas Kelvich — [REVIEWER] Cofounder of Neon and a long-time Postgres contributor. Deep experience with scaling and tuning Postgres for large production workloads.
- Jonathan Katz — [REVIEWER] PostgreSQL Core Team member and Principal Product Manager at AWS (Amazon RDS). Active in the PostgreSQL community for over 15 years: co-chair of PGConf US, Secretary of the US PostgreSQL Association, and a contributor to pgvector.
- [You] - If you have experience scaling Postgres and would like to contribute, please reach out.
Call for Contributors
We are looking for skill contributors with:
- Deep, proven experience helping a diverse set of applications build and scale on Postgres
- A track record of writing clearly about Postgres (blog posts, documentation, conference talks)
Skill contributions are paid. Open an issue or reach out to andy.hattemer@databricks.com if you're interested in contributing.
AI Policy
Skills must be written by humans. AI-generated content defeats the purpose: if the information can be generated by an AI on demand, there is no value in encoding it into a skill ahead of time.
The value of a skill comes from human judgment, accumulated experience, and insight that AI does not already have. That is what makes it worth installing.
AI tools may be used for reviewing and testing skill content, but not for authoring it.
Install the whole package (2 skills):
npx skills add https://github.com/neondatabase/postgres-skillsOr install a single skill:
npx skills add https://github.com/neondatabase/postgres-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.