gem-hunter

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.

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.

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

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

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.

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.

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.

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.

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

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.

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.

Neon Realtime makes any SQL query live. Build realtime, reactive apps and agents on Lakebase Postgres, with type-safe live queries and optimistic mutations.

npx skills add neondatabase/agent-skills

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.

Antigravity reads its Marketplace metadata from .antigravity-plugin/plugin.json and its native Neon MCP Server configuration from mcp_config.json. Install the plugin from this repository:

agy plugin install https://github.com/neondatabase/agent-skills

Confirm that Antigravity discovered the plugin, its skills, and the MCP server:

agy plugin list

To authenticate, run /mcp in Antigravity, select the Neon MCP server, and complete the OAuth flow.

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.

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

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

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?