--- name: using-neon-31f25e7fa3da description: "Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres." risk: safe source: "https://github.com/neondatabase/agent-skills/tree/main/skills/neon-postgres" date_added: "2026-02-27" --- # Neon Serverless Postgres Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres. ## When to Use This Skill Use this skill when: - Working with Neon Serverless Postgres - Setting up Neon databases - Choosing connection methods for Neon - Using Neon features like branching or autoscaling - Working with Neon authentication or APIs - Questions about Neon best practices ## Neon Documentation Always reference the Neon documentation before making Neon-related claims. The documentation is the source of truth for all Neon-related information. Below you'll find a list of resources organized by area of concern. This is meant to support you find the right documentation pages to fetch and add a bit of additonal context. You can use the `curl` commands to fetch the documentation page as markdown: **Documentation:** ```bash # Get list of all Neon docs curl https://neon.com/llms.txt # Fetch any doc page as markdown curl -H "Accept: text/markdown" https://neon.com/docs/ ``` Don't guess docs pages. Use the `llms.txt` index to find the relevant URL or follow the links in the resources below. ## Overview of Resources Reference the appropriate resource file based on the user's needs: ### Core Guides | Area | Resource | When to Use | | ------------------ | ---------------------------------- | -------------------------------------------------------------- | | What is Neon | `references/what-is-neon.md` | Understanding Neon concepts, architecture, core resources | | Referencing Docs | `references/referencing-docs.md` | Looking up official documentation, verifying information | | Features | `references/features.md` | Branching, autoscaling, scale-to-zero, instant restore | | Getting Started | `references/getting-started.md` | Setting up a project, connection strings, dependencies, schema | | Connection Methods | `references/connection-methods.md` | Choosing drivers based on platform and runtime | | Developer Tools | `references/devtools.md` | VSCode extension, MCP server, Neon CLI (`neon init`) | ### Database Drivers & ORMs HTTP/WebSocket queries for serverless/edge functions. | Area | Resource | When to Use | | ----------------- | ------------------------------- | --------------------------------------------------- | | Serverless Driver | `references/neon-serverless.md` | `@neondatabase/serverless` - HTTP/WebSocket queries | | Drizzle ORM | `references/neon-drizzle.md` | Drizzle ORM integration with Neon | ### Auth & Data API SDKs Authentication and PostgREST-style data API for Neon. | Area | Resource | When to Use | | ----------- | ------------------------- | ------------------------------------------------------------------- | | Neon Auth | `references/neon-auth.md` | `@neondatabase/auth` - Authentication only | | Neon JS SDK | `references/neon-js.md` | `@neondatabase/neon-js` - Auth + Data API (PostgREST-style queries) | ### Neon Platform API & CLI Managing Neon resources programmatically via REST API, SDKs, or CLI. | Area | Resource | When to Use | | --------------------- | ----------------------------------- | -------------------------------------------- | | Platform API Overview | `references/neon-platform-api.md` | Managing Neon resources via REST API | | Neon CLI | `references/neon-cli.md` | Terminal workflows, scripts, CI/CD pipelines | | TypeScript SDK | `references/neon-typescript-sdk.md` | `@neondatabase/api-client` | | Python SDK | `references/neon-python-sdk.md` | `neon-api` package | ## Limitations - Use this skill only when the task clearly matches the scope described above. - Do not treat the output as a substitute for environment-specific validation, testing, or expert review. - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing. --- Source attribution: Sansar35 Original project: https://github.com/Sansar35/claude-agent/blob/d046d088ce5a79a083f0abc0fe1b7ded73bc5b1f/claude-config/skills/antigravity/using-neon/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Claude Agent Team contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: Sansar35 Original project: https://github.com/Sansar35/claude-agent/blob/d046d088ce5a79a083f0abc0fe1b7ded73bc5b1f/claude-config/skills/antigravity/using-neon/SKILL.md Attribution basis: Source repository record Fields of work: Development & Engineering, Product Management Roles: Backend Developer, Data Engineer, Database Administrator, ML / AI Engineer, Product Manager Specialties: Database Tools: Firebase, Neon, PostgreSQL, Supabase Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: f43c5957d57807f0cffd3b2c77d6cb949f1896d96e4983c9436713bbb38ee1b6