Agent skill

Using Neon

by davila7 in davila7/claude-code-templates

Guides and best practices for working with Neon Serverless Postgres.

MITAuto-check passedBackend & APIs

Install Using Neon

skills CLI
$ npx skills add davila7/claude-code-templates --skill using-neon -a claude-code

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

GitHub CLI
$ gh skill install davila7/claude-code-templates using-neon --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/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/database/using-neon .claude/skills/using-neon && 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
using-neon
GitHub stars
32k
Used in
6 other repos
Token cost
~1.1k tokens
SKILL.md length
310 words
Files
30 (incl. references)
Skills in repo
477
Repo updated
First seen
Licence
MIT

At a glance

Guides and best practices for working with Neon Serverless Postgres.

  • Any Neon-related questions
  • SKILL.md covers Neon Documentation and Overview of Resources
  • Calls curl; reaches neon.tech

What it does

Using Neon is an agent skill from davila7/claude-code-templates. 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.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 32 other files, including reference files (for example `references/connection-methods.md`, `references/devtools.md` and `references/features.md`).

It sits in Backend & APIs. It works with Neon and PostgreSQL. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • Any Neon-related questions

Example prompts

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

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 14680ec. 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

    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.tech

    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

Using Neon loads about 1.1k tokens when it runs, and up to ~46k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 310 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~46k

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 davila7/claude-code-templates at commit 14680ec, republished under its MIT licence (© davila7). 310 words, ~1,082 tokens.

Download SKILL.mdSave it as .claude/skills/using-neon/SKILL.md (or your agent's skills folder). This skill also uses 29 other files; get the full folder from GitHub.
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/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

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.tech/llms.txt

# Fetch any doc page as markdown
curl -H "Accept: text/markdown" https://neon.tech/docs/<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
AreaResourceWhen to Use
What is Neonreferences/what-is-neon.mdUnderstanding Neon concepts, architecture, core resources
Referencing Docsreferences/referencing-docs.mdLooking up official documentation, verifying information
Featuresreferences/features.mdBranching, autoscaling, scale-to-zero, instant restore
Getting Startedreferences/getting-started.mdSetting up a project, connection strings, dependencies, schema
Connection Methodsreferences/connection-methods.mdChoosing drivers based on platform and runtime
Developer Toolsreferences/devtools.mdVSCode extension, MCP server, Neon CLI (neon init)
Database Drivers & ORMs

HTTP/WebSocket queries for serverless/edge functions.

AreaResourceWhen to Use
Serverless Driverreferences/neon-serverless.md@neondatabase/serverless - HTTP/WebSocket queries
Drizzle ORMreferences/neon-drizzle.mdDrizzle ORM integration with Neon
Auth & Data API SDKs

Authentication and PostgREST-style data API for Neon.

AreaResourceWhen to Use
Neon Authreferences/neon-auth.md@neondatabase/auth - Authentication only
Neon JS SDKreferences/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.

AreaResourceWhen to Use
Platform API Overviewreferences/neon-platform-api.mdManaging Neon resources via REST API
Neon CLIreferences/neon-cli.mdTerminal workflows, scripts, CI/CD pipelines
TypeScript SDKreferences/neon-typescript-sdk.md@neondatabase/api-client
Python SDKreferences/neon-python-sdk.mdneon-api package

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

Files

SKILL.md and 29 other files (references) in cli-tool/components/skills/database/using-neon of davila7/claude-code-templates.

  • SKILL.md
  • references/connection-methods.md
  • references/devtools.md
  • references/features.md
  • references/getting-started.md
  • references/neon-auth.md
  • references/neon-auth/auth-methods.md
  • references/neon-auth/common-mistakes.md
  • references/neon-auth/setup-nextjs.md
  • references/neon-auth/setup-react-spa.md
  • references/neon-auth/ui-components.md
  • references/neon-cli.md
  • references/neon-drizzle.md
  • references/neon-js.md
  • references/neon-js/common-mistakes.md
  • references/neon-js/data-api.md
  • references/neon-platform-api.md
  • references/neon-python-sdk.md
  • … and 12 more

Open the folder on GitHubat commit 14680ec

Used in 6 other repositories

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

Compare with similar skills

Using Neon 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.

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

Similar skills

  • Guides and best practices for working with Neon Serverless Postgres.

    732 GitHub starsUsed in 2 repos~1.8k tokens
    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 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 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
  • 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
  • Neon Postgres

    aiskillstore/marketplace

    Guides and best practices for working with Neon Serverless Postgres.

    430 GitHub starsUsed in 4 repos~4.2k tokens
    DatabasesAuto-check: notes

More from davila7/claude-code-templates

All 477 skills in this repo
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    32k GitHub starsUsed in 12 repos~3.5k tokens
    Auto-check: notes
  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    32k GitHub starsUsed in 10 repos~2.8k tokens
    Auto-check passed
  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    32k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes
  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    32k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Works with

Questions about Using Neon

What does Using Neon do?

Guides and best practices for working with Neon Serverless Postgres. Using Neon is an agent skill from davila7/claude-code-templates. Guides and best practices for working with Neon Serverless Postgres.

When should I use Using Neon?

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

How do I install Using Neon in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill using-neon -a claude-code`. Or copy the skill folder (cli-tool/components/skills/database/using-neon in davila7/claude-code-templates) into .claude/skills/using-neon in your project. Claude Code loads it when a task matches its description.

How do I install Using Neon in Codex?

Run `npx skills add davila7/claude-code-templates --skill using-neon -a codex`. Or copy the skill folder (cli-tool/components/skills/database/using-neon in davila7/claude-code-templates) into .agents/skills/using-neon in your project. Codex loads it when a task matches its description.

Can I use Using Neon 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 davila7/claude-code-templates --skill using-neon -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-neon, .gemini/skills/using-neon, .github/skills/using-neon and .opencode/skills/using-neon in your project.

What does Using Neon need to run?

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

Does Using Neon access the network?

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

Is Using Neon 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 Using Neon use?

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

How many tokens does Using Neon use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 45k tokens, read only when the agent opens those files.

What are the alternatives to Using Neon?

Skills that share tags, products or a category with Using Neon: Neon Postgres (Xe/site, 732 stars), Neon Postgres (usenotra/notra, 256 stars), Neon Auth (neondatabase/agent-skills, 100 stars) and Neon Postgres (neondatabase/agent-skills, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Neon?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,463 GitHub stars. The repository holds 477 skills in this directory. The repository was last updated on October 8, 2026.

Source: davila7/claude-code-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.