Skip to main content
skill CX Codex

using-neon — Claude Code skill: what it does, how to install

The using-neon skill guides agents through Neon Serverless Postgres work, from connection choices to APIs and features such as branching, autoscaling, and scale-to-zero.

MIT ★ 50,109 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sickn33/agentic-awesome-skills --skill using-neon -a claude-code
Open on GitHub

What using-neon does

using-neon gives an agent focused guidance for Neon Serverless Postgres tasks. It covers database setup, connection choices, branching, autoscaling, instant restore, and scale-to-zero, along with Neon Auth, platform APIs, and developer tools. Neon follows the Postgres interface, so the guidance applies to languages, frameworks, and ORMs that support Postgres.

The skill organizes references for core concepts, connection methods, @neondatabase/serverless, Drizzle ORM, SDKs, the CLI, and the Platform API. It uses https://neon.com/llms.txt to locate current documentation and provides curl commands for fetching pages as Markdown. Neon details should be checked against that documentation before they are treated as current.

What it helps with

  • configure a Neon database connection
  • choose a driver for serverless or edge functions
  • work with Neon branching and autoscaling
  • select a Neon SDK, CLI, or Platform API path
  • connect Neon with Drizzle ORM

Example prompts for the agent

  • Set up this project’s Neon connection and choose the right connection method for its runtime.
  • Compare @neondatabase/serverless, Drizzle ORM, and standard Postgres options for this project.
  • Check the Neon documentation for a branching and Platform API workflow here.

How to install using-neon

1Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill using-neon -a claude-code

2Manually: put the files in place

~/.claude/skills/using-neon/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/using-neon/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about using-neon

How do I install using-neon in Claude Code?

Run npx skills add sickn33/agentic-awesome-skills --skill using-neon -a claude-code, then check ~/.claude/skills/using-neon/SKILL.md.

What does using-neon do?

The skill guides agents working with Neon Serverless Postgres. It points them to connection methods, platform features, SDKs, the CLI, APIs, and ORM integrations.

What projects is using-neon compatible with?

It targets Neon, which is compatible with Postgres. It fits languages, frameworks, and ORMs that support Postgres.

Source text

SKILL.md · MIT
---
name: using-neon
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"
---
## Supporting material availability

This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:

- `<support-root>/references/what-is-neon.md`
- `<support-root>/references/referencing-docs.md`
- `<support-root>/references/features.md`
- `<support-root>/references/getting-started.md`
- `<support-root>/references/connection-methods.md`
- `<support-root>/references/devtools.md`
- `<support-root>/references/neon-serverless.md`
- `<support-root>/references/neon-drizzle.md`
- `<support-root>/references/neon-auth.md`
- `<support-root>/references/neon-js.md`
- `<support-root>/references/neon-platform-api.md`
- `<support-root>/references/neon-cli.md`
- `<support-root>/references/neon-typescript-sdk.md`
- `<support-root>/references/neon-python-sdk.md`

Obtain the required material from the [declared upstream source](https://github.com/neondatabase/agent-skills/tree/main/skills/neon-postgres), or from a user-provided installation of that source. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.


# 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/REPLACE_WITH_DISCOVERED_PATH"
```

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.

© sickn33 · MIT · sickn33/agentic-awesome-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set187

The whole set →
aws-skills Plans and reviews AWS architecture and infrastructure changes before an agent touches anything in your cloud account. CX Codex +1 ★ 50,109repo stars github-automation github-automation drives GitHub issues, pull requests, branches, workflows and permissions through Rube MCP, and halts when repository policy points elsewhere. CX Codex +1 ★ 50,109repo stars google-calendar-automation google-calendar-automation is a Claude Code skill for managing Google Calendar through an existing authenticated connector. It requires confirmation before scheduling or canceling meetings. CX Codex +1 ★ 50,109repo stars fal-platform fal-platform — a skill for platform APIs: see which models an account can reach, what a run costs and how much has already been spent. CX Codex +1 ★ 50,109repo stars auth-implementation-patterns auth-implementation-patterns — a skill that walks the agent through auth design and review: token lifecycle, sessions, policy enforcement points. CX Codex +1 ★ 50,109repo stars rclone_serve_ftp rclone_serve_ftp launches Rclone's built-in FTP server for any configured remote storage path. Handy when you need to expose cloud files to legacy FTP clients or scripts. CX Codex +1 ★ 50,109repo stars rclone_serve_nfs The rclone_serve_nfs command exposes an rclone remote through an NFSv3 server. Use it when a remote needs to appear as a mounted filesystem. CX Codex +1 ★ 50,109repo stars rclone_nfsmount rclone_nfsmount mounts cloud storage as an NFS filesystem. Unix only, requires an NFS client and mount permissions. CX Codex +1 ★ 50,109repo stars

Project sponsors

Companies that keep this analytics open