Agent Skills for Neon Severless Postgres
Start reading — 9 minnpx skills add neondatabase/agent-skills/plugin marketplace add neondatabase/agent-skillsApache-2.090 stars17,986 wordsUpdated 23 September 2026
Credited skills
9 skills · 83 min
| Week | Installs |
|---|---|
| Week 1 | 18,928 |
| Week 2 | 25,105 |
| Week 3 | 25,575 |
| Week 4 | 30,047 |
| Week 5 | 34,316 |
| Week 6 | 33,988 |
| Week 7 | 34,683 |
| Week 8 | 33,820 |
A collection of Agent Skills (opens in a new tab) and agent integrations for Neon — a complete set of cloud backend primitives built around Lakebase Postgres, for developers, startups, and agent platforms, from Databricks.
Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. Once installed, skills are automatically invoked by the agent upon detection of relevant tasks.
It all starts with the SKILL.md file in the skill’s directory. It’s the entry point and allows agents to progressively discover information as needed.
An overview of Neon for apps and agents — Lakebase Postgres, Auth, Data API, Object Storage, Compute Functions, and the AI Gateway — and how to get started. Includes Claimable Neon for use with no Neon account.
A comprehensive index of documentation and best practices for Lakebase Postgres on Neon, to set your agents up for success.
Neon Auth (Managed Better Auth) for login, users, and sessions that branch with the database, including which Better Auth plugins are supported and when to run self-managed Better Auth on Neon instead.
For agent platforms, codegen tools, and multi-tenant SaaS products that provision and run Lakebase Postgres, Object Storage, Functions, Managed Better Auth, and/or AI Gateway access for their users. Includes a companion skill and samples in neondatabase/neon-for-agent-platforms (opens in a new tab).
Choose and create the right Neon branch type for migration testing and isolated development workflows, including schema-only branches for sensitive data and reset-from-parent workflows to quickly realign child branches.
Diagnose and fix excessive Postgres egress (network data transfer) in a codebase. Use when investigating high database bills, unexpected data transfer costs, or query overfetching.
S3-compatible object storage that branches with your Neon project, so files and database rows stay in sync across dev, preview, and production environments.
One API and one Neon credential for frontier and open-source LLMs from multiple providers, built into your branch and compatible with the OpenAI, Anthropic, and Vercel AI SDKs.
Long-running, serverless Node.js HTTP functions deployed onto your Neon branch, with DATABASE_URL injected automatically and compute that runs next to your data.
npx skills add neondatabase/agent-skillsThe repository root is a portable Agent Plugins v1 (opens in a new tab) package, so any conforming client can install it straight from this repo. The root plugin.json (opens in a new tab) declares the plugin, mcp.json (opens in a new tab) declares the Neon MCP Server (opens in a new tab), and the skills are the directories under skills/.
The Claude Code and Cursor packaging under plugins/ remains available for clients that expect those formats.
You can also install the skills as a Claude Code plugin, which bundles the Neon agent skills and the Neon MCP Server (opens in a new tab) for natural language database management:
/plugin marketplace add neondatabase/agent-skills
/plugin install neon-postgres@neonAfter installation, you’ll be prompted to authenticate with Neon via OAuth when you first use MCP tools.
The top-level skills/ directory remains the source of truth. Plugin folders ship real copies of the skill directories they expose, regenerated with npm run sync:plugins — see CONTRIBUTING.md (opens in a new tab) for details.
This repository also includes Cursor plugin packaging with the same scope as the Claude plugin (the Neon agent skills and the Neon MCP Server).
Run this command in chat:
/add-plugin neon-postgresKimi Code CLI reads its own manifest at kimi.plugin.json (opens in a new tab), which points at the skills under skills/ and declares the Neon MCP Server (opens in a new tab). Install it from this repo in chat:
/plugins install https://github.com/neondatabase/agent-skillsPlugin changes apply to new sessions, so run /new afterward.
You can also install the skills in Pi (opens in a new tab) from npm:
pi install npm:@neon/skillsOr straight from this repo:
pi install git:github.com/neondatabase/agent-skillsExample prompts:
Get started with NeonRecommend a connection method for this projectSet up Drizzle ORM with NeonSet up Neon Auth for my Next.js appQuery the database using neon-jsCreate a new Neon branch using the APIUse the serverless driver for edge functionsGive me a quick temporary Postgres databaseWhy is my Neon bill so high?main, last pushed 23 September 2026.SKILL.md, not by matching a directory convention. 2 distinct layouts observed: evals/neon-postgres-egress-optimizer/.claude/skills/*/SKILL.md, skills/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Andre Landgraf, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree./neondatabase/agent-skills.md, and each skill at its own .md URL.