Neon Agent Skills

# Neon Agent Skills: setup notes

This kit holds setup notes written by Mindket. It does not contain the skills, the plugin files or the Neon CLI. Those come from Neon’s repository: https://github.com/neondatabase/agent-skills

License: Apache-2.0. Full text: https://github.com/neondatabase/agent-skills/blob/main/LICENSE

Neon Agent Skills is made by Neon. The README describes Neon as a set of cloud backend pieces around Lakebase Postgres, from Databricks. It is not made or endorsed by Anthropic, and Mindket is not affiliated with Neon.

The pages these notes came from: the README (https://github.com/neondatabase/agent-skills/blob/main/README.md), each skill’s SKILL.md under https://github.com/neondatabase/agent-skills/tree/main/skills, the plugin files plugin.json, mcp.json, kimi.plugin.json and .claude-plugin/marketplace.json, and CONTRIBUTING.md. Facts about Claude Code’s plugins and skills come from Claude Code’s own docs (https://code.claude.com/docs/en/discover-plugins and https://code.claude.com/docs/en/skills), named where they are used. Mindket copied every command and ran none of them.

## What it is

Seven skills that teach an agent to build on Neon, a set of backend pieces around Lakebase Postgres. The skills’ overview says all of them branch together: a branch is a copy-on-write clone of your data, and the other pieces follow it.

| Skill | What it covers |
|---|---|
| neon | The overview: choosing Neon pieces, the Neon CLI and MCP server, the branch-first workflow, neon.ts, logs |
| neon-postgres | Connections, pooled and direct strings, migrations, branching, autoscaling, scale to zero, restore, replicas, egress, search |
| neon-auth | Login for a new app with Managed Better Auth, and when to keep or self-host another provider |
| neon-object-storage | S3-compatible file storage that branches with the database |
| neon-functions | Long-running serverless Node.js functions on a branch, with WebSocket and SSE servers and triggers |
| neon-ai-gateway | One API and one Neon credential for LLM and embedding models from several providers |
| neon-realtime | Live SQL queries for reactive apps and agents. The skill calls it beta |

Source: each skill’s frontmatter and text. The README also lists an eighth skill, neon-postgres-agent-platforms, for platforms that run Neon for their users. It lives in a separate repository, neondatabase/neon-for-agent-platforms, and is not in the repository this kit points to.

## Files in this kit

- setup/claude-code.md: the README’s plugin route for Claude Code, and the skills CLI line
- setup/cursor.md: the README’s Cursor plugin line
- setup/antigravity.md: the README’s Antigravity plugin lines
- setup/kimi-code.md: the README’s Kimi Code plugin line
- setup/pi.md: the README’s two Pi lines
- setup/other-agents.md: the skills CLI line, the portable plugin files, and the Neon CLI’s own skills command
- setup/first-run.md: the account, the Neon CLI, signing in, regions, credits and what the skills change

## What you need first

- An agent that loads skills or plugins. The README names Claude Code, Cursor, Antigravity, Kimi Code and Pi.
- A Neon account for most work. The overview skill describes a free plan, and a no-account path for a temporary database that expires (setup/first-run.md).
- Node and npm for the Neon CLI, which the skills prefer over the MCP server.
- For Object Storage, Functions, the AI Gateway and Realtime, a project in one of four AWS regions that the skills name (setup/first-run.md).
- For the AI Gateway, prepaid credits. The skill says no model is enabled until a card is added and credits are bought, on any plan.

## What installs where

- Plugin route: the seven skills and the Neon MCP server, managed by your agent.
- Skills CLI route: the skills. The README does not say which folder it writes to or whether it adds the MCP server.
- In a project that Claude works on: a git-ignored .neon file after neon link, a neon.ts file, and an .env or .env.local file with the branch’s database address and other values. Keep that file out of git.

## Your data

The skills have Claude read Neon’s docs at neon.com. Through the Neon CLI or the MCP server, Claude can act on your Neon account: create projects and branches, run SQL, apply neon.ts and deploy functions. The neon skill says that with OAuth you pick scopes on the consent page, and that neon mcp has a --read-only flag. plugin.json’s description says you choose read-only or full access when you authorize. See setup/first-run.md.

After a task, the neon skill tells Claude to send Neon a feedback report about a problem Neon could fix, when a feedback command works without asking you. The skill says never to include secrets or personal data. Tell Claude not to if you do not want that.

What you paste or give Claude goes to Claude as in any other Claude work.

## Update and remove

The neon skill says to check the skills each session with neon skills status and update with neon skills update -y, and that skills installed through a plugin update automatically. The README’s migration note says that if you installed neon-postgres-branches or neon-postgres-egress-optimizer, you update neon-postgres and remove those two old skill folders. Claude Code’s plugin page covers updating and uninstalling a plugin from /plugin.

README.md  5 KB
setup/antigravity.md  814 B
setup/claude-code.md  3 KB
setup/cursor.md  698 B
setup/first-run.md  5 KB
setup/kimi-code.md  624 B
setup/other-agents.md  2 KB
setup/pi.md  621 B