# neon-postgres-branches

> Claude/Codex skill by [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 105 stars · Updated 2026-10-23

Choose and create the right Neon branch type for testing and development. Use when users ask about Neon branching, migration testing with real data, isolated test environments, schema-only branch workflows for sensitive data, resetting a branch from its parent, branch expiration and CI/CD branch lifecycles, or branch creation via Neon CLI or Neon MCP. Triggers include "Neon branch", "test migrations safely", "branch production data", "schema-only branch", "reset branch", "branch per PR" and "sensitive data testing".

## Install

```sh
git clone https://github.com/neondatabase/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/neon-postgres-branches ~/.claude/skills/neon-postgres-branches
```

## From README

Lakebase Postgres Branching Outcome: a created Neon branch — or a clear, actionable next step if creation cannot proceed. Choose the correct branch type, then execute branch creation with the CLI (or MCP where the CLI isn't usable). Normal branch for realistic migration and query testing with real data. Schema-only branch (Beta) for sensitive data workflows where structure is needed without copying rows. Branch Type Decision Use this decision rule first: If the user wants to test complex migrations, performance, or behavior against production-like data, choose a normal branch. If the user needs to avoid copying sensitive data, choose a schema-only branch. If the request is ambiguous, ask one clarifying question: "Do you need realistic data for testing, or only schema structure because the data is sensitive?" Tool Selection: CLI or MCP Support both the Neon CLI and the Neon MCP server, but default to the CLI.

## Links

- HTML page: https://omgskills.com/library/neondatabase/agent-skills/skills/neon-postgres-branches/
- GitHub: https://github.com/neondatabase/agent-skills
- Author: [@neondatabase](https://omgskills.com/library/neondatabase/index.md)

## More from this repo

- [neon-postgres](https://omgskills.com/library/neondatabase/agent-skills/neon-postgres/index.md) — Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations,...
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 108 stars
- [neon-postgres-egress-optimizer](https://omgskills.com/library/neondatabase/agent-skills/neon-postgres-egress-optimizer/index.md) — Diagnose and fix excessive Postgres egress (network data transfer) in a codebase.
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 108 stars
- [neon](https://omgskills.com/library/neondatabase/agent-skills/skills/neon/index.md) — Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions,...
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 105 stars