{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/using-neon",
  "version": "1.0.0",
  "name": "Using Neon",
  "description": "Guides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/...",
  "system_prompt_fragment": "# Neon Serverless Postgres\n\nNeon 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.\n\n## When to Use This Skill\n\nUse this skill when:\n- Working with Neon Serverless Postgres\n- Setting up Neon databases\n- Choosing connection methods for Neon\n- Using Neon features like branching or autoscaling\n- Working with Neon authentication or APIs\n- Questions about Neon best practices\n\n## Neon Documentation\n\nAlways reference the Neon documentation before making Neon-related claims. The documentation is the source of truth for all Neon-related information.\n\nBelow 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.\n\nYou can use the `curl` commands to fetch the documentation page as markdown:\n\n**Documentation:**\n\n```bash\n# Get list of all Neon docs\ncurl https://neon.com/llms.txt\n\n# Fetch any doc page as markdown\ncurl -H \"Accept: text/markdown\" https://neon.com/docs/<path>\n```\n\nDon't guess docs pages. Use the `llms.txt` index to find the relevant URL or follow the links in the resources below.\n\n## Overview of Resources\n\nReference the appropriate resource file based on the user's needs:\n\n### Core Guides\n\n| Area               | Resource                           | When to Use                                                    |\n| ------------------ | ---------------------------------- | -------------------------------------------------------------- |\n| What is Neon       | `references/what-is-neon.md`       | Understanding Neon concepts, architecture, core resources      |\n| Referencing Docs   | `references/referencing-docs.md`   | Looking up official documentation, verifying information       |\n| Features           | `references/features.md`           | Branching, autoscaling, scale-to-zero, instant restore         |\n| Getting Started    | `references/getting-started.md`    | Setting up a project, connection strings, dependencies, schema |\n| Connection Methods | `references/connection-methods.md` | Choosing drivers based on platform and runtime                 |\n| Developer Tools    | `references/devtools.md`           | VSCode extension, MCP server, Neon CLI (`neon init`)           |\n\n### Database Drivers & ORMs\n\nHTTP/WebSocket queries for serverless/edge functions.\n\n| Area              | Resource                        | When to Use                                         |\n| ----------------- | ------------------------------- | --------------------------------------------------- |\n| Serverless Driver | `references/neon-serverless.md` | `@neondatabase/serverless` - HTTP/WebSocket queries |\n| Drizzle ORM       | `references/neon-drizzle.md`    | Drizzle ORM integration with Neon                   |\n\n### Auth & Data API SDKs\n\nAuthentication and PostgREST-style data API for Neon.\n\n| Area        | Resource                  | When to Use                                                         |\n| ----------- | ------------------------- | ------------------------------------------------------------------- |\n| Neon Auth   | `references/neon-auth.md` | `@neondatabase/auth` - Authentication only                          |\n| Neon JS SDK | `references/neon-js.md`   | `@neondatabase/neon-js` - Auth + Data API (PostgREST-style queries) |\n\n### Neon Platform API & CLI\n\nManaging Neon resources programmatically via REST API, SDKs, or CLI.\n\n| Area                  | Resource                            | When to Use                                  |\n| --------------------- | ----------------------------------- | -------------------------------------------- |\n| Platform API Overview | `references/neon-platform-api.md`   | Managing Neon resources via REST API         |\n| Neon CLI              | `references/neon-cli.md`            | Terminal workflows, scripts, CI/CD pipelines |\n| TypeScript SDK        | `references/neon-typescript-sdk.md` | `@neondatabase/api-client`                   |\n| Python SDK            | `references/neon-python-sdk.md`     | `neon-api` package                           |",
  "applicable_domains": [
    "other"
  ],
  "category": "other",
  "invocation": [
    "/using-neon"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/using-neon",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/using-neon",
    "license": "Apache-2.0",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists. Upstream as recorded by the aggregator: https://github.com/neondatabase/agent-skills/tree/main/skills/neon-postgres. License Apache-2.0 read from github.com/neondatabase/agent-skills on 2026-09-03."
  },
  "tags": [
    "claudeskills",
    "other",
    "risk-reviewed"
  ],
  "lifecycle": "draft"
}