---
title: "neon-postgres skill: connect, migrate, branch and tune Neon"
canonical_url: https://cookiesforai.app/skills/neondatabase/neon-postgres
last_updated: 2026-10-02T03:01:13+02:00
type: skill
summary: "neon-postgres is Neon's agent skill for working with Postgres on Neon: connection strings, pooled or direct connections, migrations, branching, built-in diagnostics, autoscaling, scale to zero and search."
install: "npx skills add neondatabase/agent-skills --skill neon-postgres"
related:
  - "https://cookiesforai.app/skills/wshobson/database-migration"
  - "https://cookiesforai.app/skills/supabase/supabase-postgres-best-practices"
  - "https://cookiesforai.app/skills/prisma/prisma-upgrade-v7"
  - "https://cookiesforai.app/skills/supabase/supabase"
---

# Neon Postgres

neon-postgres is Neon's agent skill for working with Postgres on Neon: connection strings, pooled or direct connections, migrations, branching, built-in diagnostics, autoscaling, scale to zero and search.

| Fact | Value |
|---|---|
| Publisher | Neon (official, own GitHub account) |
| Source | https://github.com/neondatabase/agent-skills/tree/HEAD/skills/neon-postgres |
| License | Apache-2.0 |
| Repository stars | 98 on 2026-10-02 |
| Skill name | neon-postgres |
| Category | Databases |
| Skill last changed | 2026-09-23 |
| Page updated | 2026-10-02 |
| Facts checked | 2026-10-02 |

## Install

Install this skill with the skills CLI:

```
npx skills add neondatabase/agent-skills --skill neon-postgres
```

Or, in Claude Code, add Neon's plugin marketplace:

```
/plugin marketplace add neondatabase/agent-skills
```

Then install the neon-postgres plugin (Neon's skills plus the Neon MCP server):

```
/plugin install neon-postgres@neon
```

Or, in Cursor, run this in chat:

```
/add-plugin neon-postgres
```

With the plugin routes, Neon asks you to sign in through OAuth the first time an MCP tool runs.

## Ask your coding agent

A skill can include scripts that run on your computer, so read its source first: https://github.com/neondatabase/agent-skills/tree/HEAD/skills/neon-postgres

```text
Install the agent skill neon-postgres from github.com/neondatabase/agent-skills.
```

## What it does

neon-postgres is an agent skill from Neon for Postgres databases hosted on Neon, which Neon now calls Lakebase Postgres. It tells the agent to reuse a DATABASE_URL already present in the prompt, environment or repo, and otherwise to pick or create a project with the Neon CLI or MCP server. A table decides between pooled connections, for web apps and serverless functions, and direct ones, for migrations, dumps, replication and LISTEN.

The neon-postgres skill gives driver choices per platform: node-postgres with Fluid compute on Vercel, node-postgres with Hyperdrive on Cloudflare, and Neon's serverless driver for edge runtimes. Migrations are managed as code through the project's ORM, tested first on a branch of production data and run over a direct connection. Branches are copy-on-write clones, each with its own compute.

For slow queries the skill maps symptoms to read-only neon inspect checks such as outliers, unused-indexes, locks, bloat and cache hit rate, with warnings on how not to misread them, and hands query and index work to a separate postgres-best-practices skill. Other topics include read replicas, logical replication, instant restore, IP allow lists, search, and how autoscaling and scale to zero work.

## When to use it

- You are connecting an app to Neon and are unsure whether to use the pooled or the direct URL.
- You want to test a schema migration on a copy of production data first.
- Your Neon database got slow and you want the built-in diagnostics run.
- You want to know how scale to zero and cold starts affect your app.

## When to pick something else

- Starting a new backend with auth, files or functions: Neon routes that to its parent neon skill in the same repository.

## What it needs

- A Neon account or an existing Neon DATABASE_URL; the Neon CLI or the Neon MCP server for project and branch actions

## Which agents it works in

Neon documents it for Claude Code, Cursor, Kimi Code CLI, Pi, Other Agent Plugins v1 clients. The open skills CLI also installs it into 78 agents (listed with the CLI on 2026-10-01).

The skill works through the Neon CLI by default or the Neon MCP server; the Claude Code, Cursor and Kimi Code plugins install the MCP server, the skills CLI line does not.

## License

Apache-2.0.

## Related

### Related skills for databases

- [Database migration](https://cookiesforai.app/skills/wshobson/database-migration): database-migration is an agent skill from Seth Hobson's wshobson/agents marketplace for writing schema and data migrations in Sequelize, TypeORM and Prisma, with zero-downtime patterns and rollback strategies.
- [Postgres Best Practices](https://cookiesforai.app/skills/supabase/supabase-postgres-best-practices): Postgres Best Practices is Supabase's agent skill of Postgres rules for any Postgres database, ranked by impact: indexes, connection pooling, row level security and schema design.
- [Prisma upgrade to v7](https://cookiesforai.app/skills/prisma/prisma-upgrade-v7): prisma-upgrade-v7 is Prisma's agent skill for upgrading a project from Prisma ORM 6 to 7, covering every breaking change: the new generator, driver adapters, prisma.config.ts, ESM and removed features.
- [Supabase](https://cookiesforai.app/skills/supabase/supabase): Supabase is Supabase's own agent skill for any Supabase task, with a security checklist for auth and row level security and a rule to check the current docs first.