Agent Skills

A collection of Agent Skills and agent integrations for Neon — a complete set of cloud backend primitives built around Lakebase Postgres, for developers, startups, and agent platforms, from Databricks.

What are Agent Skills?

Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. Once installed, skills are automatically invoked by the agent upon detection of relevant tasks.

It all starts with the SKILL.md file in the skill's directory. It's the entry point and allows agents to progressively discover information as needed.

Available Skills

Neon

An overview of Neon for apps and agents — Lakebase Postgres, Auth, Data API, Object Storage, Compute Functions, and the AI Gateway — and how to get started. Includes Claimable Neon for use with no Neon account.

Neon Postgres

A comprehensive index of documentation and best practices for Lakebase Postgres on Neon, to set your agents up for success.

Neon Auth

Neon Auth (Managed Better Auth) for login, users, and sessions that branch with the database, including which Better Auth plugins are supported and when to run self-managed Better Auth on Neon instead.

Neon Postgres Agent Platforms

For agent platforms, codegen tools, and multi-tenant SaaS products that provision and run Lakebase Postgres, Object Storage, Functions, Managed Better Auth, and/or AI Gateway access for their users. Includes a companion skill and samples in neondatabase/neon-for-agent-platforms.

Neon Postgres Branches

Choose and create the right Neon branch type for migration testing and isolated development workflows, including schema-only branches for sensitive data and reset-from-parent workflows to quickly realign child branches.

Neon Postgres Egress Optimizer

Diagnose and fix excessive Postgres egress (network data transfer) in a codebase. Use when investigating high database bills, unexpected data transfer costs, or query overfetching.

Neon Object Storage

S3-compatible object storage that branches with your Neon project, so files and database rows stay in sync across dev, preview, and production environments.

Neon AI Gateway

One API and one Neon credential for frontier and open-source LLMs from multiple providers, built into your branch and compatible with the OpenAI, Anthropic, and Vercel AI SDKs.

Neon Functions

Long-running, serverless Node.js HTTP functions deployed onto your Neon branch, with DATABASE_URL injected automatically and compute that runs next to your data.

Installation

npx skills add neondatabase/agent-skills

Agent Plugin

The repository root is a portable Agent Plugins v1 package, so any conforming client can install it straight from this repo. The root plugin.json declares the plugin, mcp.json declares the Neon MCP Server, and the skills are the directories under skills/.

The Claude Code and Cursor packaging under plugins/ remains available for clients that expect those formats.

Claude Code Plugin

You can also install the skills as a Claude Code plugin, which bundles the Neon agent skills and the Neon MCP Server for natural language database management:

/plugin marketplace add neondatabase/agent-skills
/plugin install neon-postgres@neon

After installation, you'll be prompted to authenticate with Neon via OAuth when you first use MCP tools.

The top-level skills/ directory remains the source of truth. Plugin folders ship real copies of the skill directories they expose, regenerated with npm run sync:plugins — see CONTRIBUTING.md for details.

Cursor Plugin

This repository also includes Cursor plugin packaging with the same scope as the Claude plugin (the Neon agent skills and the Neon MCP Server).

Run this command in chat:

/add-plugin neon-postgres

Kimi Code Plugin

Kimi Code CLI reads its own manifest at kimi.plugin.json, which points at the skills under skills/ and declares the Neon MCP Server. Install it from this repo in chat:

/plugins install https://github.com/neondatabase/agent-skills

Plugin changes apply to new sessions, so run /new afterward.

Pi

You can also install the skills in Pi from npm:

pi install npm:@neon/skills

Or straight from this repo:

pi install git:github.com/neondatabase/agent-skills

Usage

Example prompts:

Get started with Neon

Recommend a connection method for this project

Set up Drizzle ORM with Neon

Set up Neon Auth for my Next.js app

Query the database using neon-js

Create a new Neon branch using the API

Use the serverless driver for edge functions

Give me a quick temporary Postgres database

Why is my Neon bill so high?

{
  "name": "neon",
  "owner": {
    "name": "Andre Landgraf",
    "email": "andre@neon.tech"
  },
  "metadata": {
    "description": "Official Neon plugins for Claude Code",
    "version": "2.1.2"
  },
  "plugins": [
    {
      "name": "neon-postgres",
      "source": "./plugins/neon-postgres",
      "description": "Manage your Neon backend with the Neon agent skills and the Neon MCP Server: Lakebase Postgres, branching, Object Storage, Functions, and the AI Gateway",
      "version": "2.1.2",
      "category": "database",
      "tags": [
        "neon",
        "lakebase",
        "postgres",
        "serverless",
        "database",
        "mcp"
      ]
    }
  ]
}