neon-postgres-branches

Guide Neon branch type and tool selection for test environment creation.

20|3|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/andrelandgraf/fullstackrecipes --skill neon-postgres-branches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neon-postgres-branches
Source: https://github.com/andrelandgraf/fullstackrecipes/tree/main/.agents/skills/neon-postgres-branches
Command: npx skills add https://github.com/andrelandgraf/fullstackrecipes --skill neon-postgres-branches

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Neon branch management often requires selecting the correct branch type and tool, plus safe setup for testing data and migrations. This Skill guides users to choose normal vs schema-only branches and to execute branch creation via MCP or CLI, ensuring isolation and reproducible environments.

Core Features & Use Cases

  • Branch Type Decision rules for normal (production-like data) vs schema-only (structure-only with sensitive data).
  • Tool Selection: supports MCP and CLI with context setup and branch creation commands.
  • Post-creation guidance: update connection strings, reset from parent, and expiration management for ephemeral environments.

Quick Start

Create a Neon branch named <branch-name> from <parent-branch> selecting the appropriate type and then run the branch creation using MCP or CLI.

Frequently Asked Questions about neon-postgres-branches

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Neon Postgres branch for testing migrations?

To create a Neon Postgres branch for testing migrations, you select a parent branch and use either the Neon MCP or CLI to execute the branch creation, optionally setting an expiration for ephemeral environments.

What is the difference between a normal and schema-only Neon branch?

A normal Neon branch copies production-like data for full testing, while a schema-only branch copies just the structure without sensitive data, ensuring isolation and reproducible environments for safe testing.

Do I need the Neon CLI or MCP to create database branches?

Yes, you need either the Neon MCP or Neon CLI available to execute database branch creation. This Skill guides tool selection and provides the context setup and commands required for either method.

Can I set an expiration on a Neon branch for ephemeral testing?

Yes, you can set an expiration on a Neon branch during creation to manage ephemeral testing environments. Post-creation guidance also includes updating connection strings and resetting from the parent branch.

What's the best way to reset a Neon testing branch from its parent?

The best way to reset a Neon testing branch is to use the provided post-creation guidance to reset from the parent branch, ensuring your testing environment stays synchronized with the source data structure.