neon

Route Neon backend tasks to the correct skill and configure CLI, MCP, and branch-first workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Neon now bundles many backend primitives (Lakebase Postgres, Auth, Object Storage, Functions, AI Gateway), and developers struggle to know which capability, tool, or workflow applies to their task. This Skill acts as the entry point that routes you to the right Neon skill and sets up the CLI, MCP server, and branch-first development flow. ## Core Features & Use Cases - Skill Routing: Maps tasks like file storage, LLM calls, or serverless APIs to the correct dedicated Neon skill (neon-postgres, neon-object-storage, neon-functions, neon-ai-gateway, and more). - Tooling Setup: Guides installation and use of the Neon CLI, MCP server, and the neon.ts infrastructure-as-code config with type-safe env vars via @neon/env. - Branch-First Workflow: Drives the neon link / neon checkout / neon diff loop so every feature gets an isolated copy-on-write database branch. - Use Case: You are building a TanStack Start app and need a database plus file uploads. This Skill identifies that you need the neon-postgres and neon-object-storage skills, walks you through npx neon@latest init --agent, and gets your branch env vars into .env.local. ## Quick Start Ask the agent to set up Neon for your project and route your database, storage, or AI task to the right Neon skill.

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 an existing project?▼

Run npx neon@latest init --agent to install the Neon CLI, MCP server, and agent skills non-interactively. Then use neon link to connect your workspace to an 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 table: neon-postgres for database work, neon-object-storage for file uploads, neon-functions for long-running or streaming APIs, neon-ai-gateway for LLM calls, and neon-postgres-branches for branch workflows. 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 Neon CLI over the MCP server because it provides more capabilities, including deploying Neon Functions. Use the MCP server only when the CLI is unavailable, blocked in your environment, not authenticated, or the user instructs otherwise.

Does Neon Object Storage work in all regions?▼

No. Object Storage, Functions, and AI Gateway are in public beta and only available on projects in the us-east-2 region. If your project is in another region, you must create a new project in us-east-2 before using these beta services.

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

Neon Auth only redirects to domains on its trusted-domains list, so sign-in fails when your app's domain changes. Fix it by running neon neon-auth domain add <domain> with the workspace linked, or neon neon-auth domain allow-localhost for local development.

What is the neon.ts file used for?▼

neon.ts is Neon's infrastructure-as-code config that declares which services each branch should have, including Auth, Data API, Functions, buckets, and AI Gateway. Reconcile it with neon config plan and neon deploy, and get type-safe env vars through parseEnv from @neon/env.