New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Neon Postgres

by Xe in Xe/site

Guides and best practices for working with Neon Serverless Postgres.

ZlibAuto-check passedBackend & APIs

Install Neon Postgres

skills CLI
$ npx skills add Xe/site --skill neon-postgres -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Xe/site neon-postgres --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Xe/site.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/neon-postgres .claude/skills/neon-postgres && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
neon-postgres
GitHub stars
732
Used in
2 other repos
Token cost
~1.8k tokens
SKILL.md length
801 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Zlib

At a glance

Guides and best practices for working with Neon Serverless Postgres.

  • Works in 2 steps: Append .md to the URL (simplest):… → Request text/markdown on the standard…
  • Any Neon-related questions
  • SKILL.md covers Neon Documentation, What Is Neon, Getting Started and Connection Methods & Drivers, plus 11 more sections
  • Calls curl and npx; reaches neon.com

What it does

Neon Postgres is an agent skill from Xe/site. 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/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. It works with Neon and PostgreSQL. The repository describes itself as: The new frontend/backend code for https://xeiaso.net. The licence is Zlib.

When your agent uses it

  • Any Neon-related questions

Example prompts

  • “Use the neon-postgres skill to guide and best practices for working with Neon Serverless Postgres”
  • “/neon-postgres”

Requirements

  • Python 3
  • Node.js

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Append .md to the URL (simplest): https://neon.com/docs/introduction/branching.md
  2. Request text/markdown on the standard URL: curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching

What it can do on your machine

Read from SKILL.md and the folder at commit 45c532e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • neon.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Neon Postgres loads about 1.8k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 801 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Xe/site at commit 45c532e, republished under its Zlib licence (© Xe). 801 words, ~1,849 tokens.

Download SKILL.mdSave it as .claude/skills/neon-postgres/SKILL.md (or your agent's skills folder).
name
neon-postgres
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/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.

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.

Neon Documentation

The Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data.

Fetching Docs as Markdown

Any Neon doc page can be fetched as markdown in two ways:

  1. Append .md to the URL (simplest): https://neon.com/docs/introduction/branching.md
  2. Request text/markdown on the standard URL: curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching

Both return the same markdown content. Use whichever method your tools support.

Finding the Right Page

The docs index lists every available page with its URL and a short description:

https://neon.com/docs/llms.txt

Common doc URLs are organized in the topic links below. If you need a page not listed here, search the docs index: https://neon.com/docs/llms.txt — don't guess URLs.

What Is Neon

Use this for architecture explanations and terminology (organizations, projects, branches, endpoints) before giving implementation advice.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/what-is-neon.md

Getting Started

Use this for first-time setup: org/project selection, connection strings, driver installation, optional auth, and initial schema setup.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/getting-started.md

Connection Methods & Drivers

Use this when you need to pick the correct transport and driver based on runtime constraints (TCP, HTTP, WebSocket, edge, serverless, long-running).

Link: https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md

Serverless Driver

Use this for @neondatabase/serverless patterns, including HTTP queries, WebSocket transactions, and runtime-specific optimizations.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-serverless.md

Neon JS SDK

Use this for combined Neon Auth + Data API workflows with PostgREST-style querying and typed client setup.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-js.md

Developer Tools

Use this for local development enablement with npx neonctl@latest init, VSCode extension setup, and Neon MCP server configuration.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/devtools.md

Neon CLI

Use this for terminal-first workflows, scripts, and CI/CD automation with neonctl.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-cli.md

Neon Admin API

The Neon Admin API can be used to manage Neon resources programmatically. It is used behind the scenes by the Neon CLI and MCP server, but can also be used directly for more complex automation workflows or when embedding Neon in other applications.

Neon REST API

Use this for direct HTTP automation, endpoint-level control, API key auth, rate-limit handling, and operation polling.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-rest-api.md

Neon TypeScript SDK

Use this when implementing typed programmatic control of Neon resources in TypeScript via @neondatabase/api-client.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-typescript-sdk.md

Neon Python SDK

Use this when implementing programmatic Neon management in Python with the neon-api package.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-python-sdk.md

Neon Auth

Use this for managed user authentication setup, UI components, auth methods, and Neon Auth integration pitfalls in Next.js and React apps.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-auth.md

Neon Auth is also embedded in the Neon JS SDK - so depending on your use case, you may want to use the Neon JS SDK instead of Neon Auth. See https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md for more details.

Show full SKILL.md (327 more words)Show less

Branching

Use this when the user is planning isolated environments, schema migration testing, preview deployments, or branch lifecycle automation.

Key points:

  • Branches are instant, copy-on-write clones (no full data copy).
  • Each branch has its own compute endpoint.
  • Use the neonctl CLI or MCP server to create, inspect, and compare branches.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/branching.md

Autoscaling

Use this when the user needs compute to scale automatically with workload and wants guidance on CU sizing and runtime behavior.

Link: https://neon.com/docs/introduction/autoscaling.md

Scale to Zero

Use this when optimizing idle costs and discussing suspend/resume behavior, including cold-start trade-offs.

Key points:

  • Idle computes suspend automatically (default 5 minutes, configurable) (unless disabled - launch & scale plan only)
  • First query after suspend typically has a cold-start penalty (around hundreds of ms)
  • Storage remains active while compute is suspended.

Link: https://neon.com/docs/introduction/scale-to-zero.md

Instant Restore

Use this when the user needs point-in-time recovery or wants to restore data state without traditional backup restore workflows.

Key points:

  • Restore windows depend on plan limits.
  • Users can create branches from historical points-in-time.
  • Time Travel queries can be used for historical inspection workflows.

Link: https://neon.com/docs/introduction/branch-restore.md

Read Replicas

Use this for read-heavy workloads where the user needs dedicated read-only compute without duplicating storage.

Key points:

  • Replicas are read-only compute endpoints sharing the same storage.
  • Creation is fast and scaling is independent from primary compute.
  • Typical use cases: analytics, reporting, and read-heavy APIs.

Link: https://neon.com/docs/introduction/read-replicas.md

Connection Pooling

Use this when the user is in serverless or high-concurrency environments and needs safe, scalable Postgres connection management.

Key points:

  • Neon pooling uses PgBouncer.
  • Add -pooler to endpoint hostnames to use pooled connections.
  • Pooling is especially important in serverless runtimes with bursty concurrency.

Link: https://neon.com/docs/connect/connection-pooling.md

IP Allow Lists

Use this when the user needs to restrict database access by trusted networks, IPs, or CIDR ranges.

Link: https://neon.com/docs/introduction/ip-allow.md

Logical Replication

Use this when integrating CDC pipelines, external Postgres sync, or replication-based data movement.

Key points:

  • Neon supports native logical replication workflows.
  • Useful for replicating to/from external Postgres systems.

Link: https://neon.com/docs/guides/logical-replication-guide.md

© Xe, Zlib. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/neon-postgres of Xe/site.

Open the folder on GitHubat commit 45c532e

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in Xe/site, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Neon Postgres next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Neon Postgres compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Neon Postgres this skillXe/site7322 repos~1.8kAutomated safety check: PassZlib
Neon Authneondatabase/agent-skills100—~3.1kAutomated safety check: PassApache-2.0
Neonneondatabase/agent-skills100—~8.7kAutomated safety check: NotesApache-2.0
Using Neondavila7/claude-code-templates32k6 repos~1.1kAutomated safety check: PassMIT
Neonericrisco/rsc-harness167—~3.5kAutomated safety check: PassMIT
Neon Postgresusenotra/notra256—~4.1kAutomated safety check: NotesAGPL-3.0

Similar skills

  • Neon Auth

    neondatabase/agent-skills

    Official

    Add authentication to a new app. An agent skill from neondatabase/agent-skills.

    100 GitHub stars~3.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Neon

    neondatabase/agent-skills

    Official

    Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, and the AI Gateway.

    100 GitHub stars~8.7k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

  • Using Neon

    davila7/claude-code-templates

    Guides and best practices for working with Neon Serverless Postgres.

    32k GitHub starsUsed in 6 repos~1.1k tokens
    Backend & APIsAuto-check passed

  • Neon

    ericrisco/rsc-harness

    A skill your agent uses when you have picked Neon (serverless Postgres) and need to connect correctly from a serverless or edge runtime, wire database branching into dev, preview and CI, or stop…

    167 GitHub stars~3.5k tokensUpdated today
    Backend & APIsAuto-check passed

  • Neon Postgres

    usenotra/notra

    Guides and best practices for working with Lakebase Postgres, the database behind Neon.

    256 GitHub stars~4.1k tokensUpdated today
    DatabasesAuto-check: notes

  • Neon Postgres

    neondatabase/agent-skills

    Official

    Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations, branching, autoscaling, scale-to-zero, instant restore, read replicas, IP…

    100 GitHub stars~4.1k tokensUpdated yesterday
    DatabasesAuto-check: notes

More from Xe/site

All 12 skills in this repo

  • Stop Slop

    Xe/site

    Remove AI writing patterns from prose. An agent skill from Xe/site.

    732 GitHub starsUsed in 8 repos~423 tokens
    Auto-check passed

  • Neon Postgres Branches

    Xe/site

    Choose and create the right Neon branch type for testing and development.

    732 GitHub starsUsed in 3 repos~2.4k tokens
    Auto-check: notes

  • Conventional Commits

    Xe/site

    A skill your agent uses when creating git commits, writing commit messages, or following version control workflows

    732 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed

  • No Way To Prevent This Memory Safety

    Xe/site

    A skill your agent uses when asked to generate a "no way to prevent this" / no-way-to-prevent-this satire post for a memory-safety CVE (out-of-bounds write/read, buffer/heap overflow…

    732 GitHub stars~816 tokensUpdated 2 days ago
    Auto-check passed

  • Templ Components

    Xe/site

    Create reusable templ UI components with props, children, and composition patterns.

    732 GitHub stars~552 tokensUpdated 2 days ago
    Auto-check passed

  • Templ HTTP

    Xe/site

    Integrate templ components with Go HTTP server using net/http.

    732 GitHub stars~591 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Neon Postgres

What does Neon Postgres do?

Guides and best practices for working with Neon Serverless Postgres. Neon Postgres is an agent skill from Xe/site. Guides and best practices for working with Neon Serverless Postgres.

When should I use Neon Postgres?

Neon Postgres fits situations like: any Neon-related questions.

How do I install Neon Postgres in Claude Code?

Run `npx skills add Xe/site --skill neon-postgres -a claude-code`. Or copy the skill folder (.agents/skills/neon-postgres in Xe/site) into .claude/skills/neon-postgres in your project. Claude Code loads it when a task matches its description.

How do I install Neon Postgres in Codex?

Run `npx skills add Xe/site --skill neon-postgres -a codex`. Or copy the skill folder (.agents/skills/neon-postgres in Xe/site) into .agents/skills/neon-postgres in your project. Codex loads it when a task matches its description.

Can I use Neon Postgres in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Xe/site --skill neon-postgres -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/neon-postgres, .gemini/skills/neon-postgres, .github/skills/neon-postgres and .opencode/skills/neon-postgres in your project.

What does Neon Postgres need to run?

Going by SKILL.md and its folder, Neon Postgres needs the command-line tools its instructions call (curl and npx). Our summary lists: Python 3; Node.js.

Does Neon Postgres access the network?

SKILL.md names 1 domain. In commands or code: neon.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Neon Postgres safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Neon Postgres use?

Neon Postgres is published under the Zlib licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Neon Postgres use?

About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Neon Postgres?

Skills that share tags, products or a category with Neon Postgres: Neon Auth (neondatabase/agent-skills, 100 stars), Neon (neondatabase/agent-skills, 100 stars), Using Neon (davila7/claude-code-templates, 32k stars) and Neon (ericrisco/rsc-harness, 167 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Neon Postgres?

Xe (a GitHub user) maintains it in Xe/site, which has 732 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 5, 2026.

Source: Xe/site on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.