neon

Guides setup and routing across Neon Postgres, Auth, Functions, Object Storage, and AI Gateway.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/dhanushreddy291/durable-workflow-on-neon-functions --skill neon-dhanushreddy291
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neon
Source: https://github.com/dhanushreddy291/durable-workflow-on-neon-functions/tree/main/.agents/skills/neon
Command: npx skills add https://github.com/dhanushreddy291/durable-workflow-on-neon-functions --skill neon-dhanushreddy291

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working with Neon often don't know which of its platform services (Postgres, Auth, Object Storage, Functions, AI Gateway) applies to their task, or how to set up the CLI, MCP server, and branch-first workflow correctly. This Skill acts as the entry point that routes you to the right Neon skill and establishes the recommended development setup. ## Core Features & Use Cases - Skill Routing: Maps your task (databases, file storage, serverless functions, LLM calls) to the correct specialized Neon skill such as neon-postgres, neon-functions, or neon-ai-gateway. - Environment Setup: Walks through installing the Neon CLI and MCP server, linking projects, and pulling branch environment variables. - Branch-First Workflow: Drives the checkout-based development loop where each feature gets an isolated copy-on-write database branch. - Use Case: You ask your agent to add file uploads to your app. This Skill recognizes the task as object storage, confirms your project is in us-east-2 for beta services, and routes to the neon-object-storage skill with the CLI already configured. ## Quick Start Ask the agent to set up Neon in your project and connect it to the right Neon service for your current task.

Frequently Asked Questions about neon

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

FAQPage Schema
How do I get started with Neon in my project?▼

Run npx neon@latest init --agent to install the Neon CLI, MCP server, and agent skills non-interactively. Then run neon link to connect your workspace to a Neon org, project, and branch, which also pulls the branch's environment variables into your local .env file.

Which Neon skill should I use for my task?▼

Match the task to the skill: neon-postgres for database work, neon-object-storage for file storage, neon-functions for long-running serverless functions, and neon-ai-gateway for LLM calls. Install missing skills with npx skills add neondatabase/agent-skills -s <skill-name>.

Should I use the Neon CLI or the MCP server?▼

Prefer the CLI unless it is unavailable, blocked, or unauthenticated, since it supports more capabilities including deploying Neon Functions. The MCP server is a fallback installed via npx -y add-mcp https://mcp.neon.tech/mcp.

Are Neon Object Storage, Functions, and AI Gateway available in all regions?▼

No. These public beta services are only available on projects in the us-east-2 region. Before using them, confirm your project is in us-east-2 or create a new project in that region.

Why does Neon Auth fail with an invalid domain error?▼

Neon Auth only redirects to domains on its trusted-domains list, so new deploy URLs or custom domains fail until registered. Fix it with neon neon-auth domain add <domain>, and verify the list with neon neon-auth domain list.

What is the branch-first development flow in Neon?▼

Create a Neon branch whenever you would create a git branch using neon checkout <branch-name>, which also pulls that branch's environment variables. Use neon diff to review schema changes against the parent branch before committing.