Neon agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Neon work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Neon

Connect Neon once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Neon skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing22 Neon tools

Use Neon safely with AI

Teaches the assistant to confirm the project, branch and Postgres role before any call, choose the right tool, and ask before changing anything. Read-only and pinned-role limits are respected.

Use it when

You want an assistant to explore a Neon project without touching production by accident
You are connecting Neon and want to know which tools are safe to use
You need the assistant to stop and ask before creating or deleting a branch

Tools it uses

list_organizations
list_projects
describe_project
describe_branch
describe_table_schema
get_database_tables
inspect_database
compare_database_schema
explain_sql_statement
get_connection_string
list_docs_resources
get_doc_resource
fetch
list_log_fields
list_log_field_values
create_project
delete_project
create_branch
delete_branch
complete_database_migration
complete_query_tuning
configure_neon_auth

Example

Check the schema on my staging branch and tell me what tables exist, but don't change anything.

Confirmed the project 'orders-app' and branch 'staging' first. Found 6 tables: customers, orders, order_items, products, refunds and audit_log. Nothing was changed. The session runs as the database owner, so I haven't checked whether a narrower role would see the same tables.

Use in RevampKeyRead the full skill →

Asks before writing9 Neon tools

Clean up Neon branches and environments

Audits a Neon project's branches, sorts them into keep, review and delete candidates, and deletes only the branches you approve. It asks before removing anything.

Use it when

A project has dozens of old preview branches and you want to know which are safe to remove
You are preparing for a quota or billing review and need to shrink branch sprawl
You suspect orphaned branches are left behind by a closed pull request

Tools it uses

list_organizations
list_projects
describe_project
list_branch_computes
get_database_tables
compare_database_schema
describe_table_schema
delete_branch
delete_project

Example

Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.

I found 18 branches in storefront-api. I'd keep 4 (main, staging, dev and one with a running compute). 9 are preview branches with no active compute and no unique tables, so they are candidates to review. 5 have child branches or tables that differ from main, so I've flagged them to check first. Nothing has been deleted; tell me which ones to remove.

Use in RevampKeyRead the full skill →

Asks before writing9 Neon tools

Roll out a Neon schema migration safely

Plans and runs a schema migration on a Neon branch: rehearses it on an isolated child branch, compares schemas, verifies behaviour, and only applies to the target after you approve the plan.

Use it when

You need to add or change tables or columns in a Neon database without guessing the impact.
You want a migration tested on a copy of the schema before it touches the real branch.
A migration has to be rolled back or justified to a teammate before it ships.

Tools it uses

list_projects
describe_project
describe_branch
describe_table_schema
create_branch
complete_database_migration
compare_database_schema
get_database_tables
inspect_database

Example

Roll out the migration that adds a status column to orders on my main branch, but rehearse it on a copy first.

Target confirmed: project shop-prod, branch main, role owner. The migration has 2 statements; the ADD COLUMN is nullable, so the risk is low. I'd create a child branch, migrate-orders-status, and run it there first. Once you say yes I'll create that branch and apply it there. Then I'll compare the schemas and check the orders queries before we touch main.

Use in RevampKeyRead the full skill →

Asks before writing10 Neon tools

Tune a slow Neon query with AI

Reads the explain plan and table schema for a slow Postgres query, proposes an index or rewrite, and tests it on an isolated branch. It asks before creating a branch or changing anything.

Use it when

A dashboard query takes several seconds on a large table
You want to know whether a Postgres query needs an index or a rewrite
You want a tuning change tested on a branch before it reaches main data

Tools it uses

list_projects
describe_project
list_branch_computes
describe_branch
explain_sql_statement
describe_table_schema
get_database_tables
create_branch
complete_query_tuning
get_connection_string

Example

The orders list query on my main branch takes 4 seconds. Can you find out why and suggest a fix?

The plan shows a sequential scan over 2.1 million rows in orders, filtered on status, with no index on that column. Estimated rows match actual, so statistics are fine. I suggest a composite index on (status, created_at) built concurrently. Want me to create a preview branch and test it there first? I will wait for your yes before creating anything.

Use in RevampKeyRead the full skill →

Read-only8 Neon tools

Review schema drift between Neon branches

Compares the schema of one Neon branch against another and returns a risk-ranked list of differences for review. It only reads, so nothing is applied or migrated.

Use it when

A preview branch has drifted from main and you want to know how far
You need to see what a migration would change before anyone runs it
You are preparing a schema review and want a clear, ranked diff

Tools it uses

describe_project
list_projects
describe_branch
compare_database_schema
get_database_tables
describe_table_schema
inspect_database
complete_database_migration

Example

Compare the schema on my feature-login branch against main and tell me which differences are risky.

I compared feature-login against main in project billing-prod. The compare found 6 differences. 1 is high risk: the orders.customer_ref column is NOT NULL with no default and has no counterpart on main. Main holds 12,400 rows, so that migration would fail without a backfill. The other 5 are lower risk: 3 added indexes and 2 nullable columns. Nothing has been applied.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Neon, updates them for you and removes them when you disconnect.

Download RevampKey

How Neon skills work

Connect Neon
The Neon MCP server gives the agent its tools.
Ask in plain words
“Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Neon skills

In RevampKey the skills install themselves when you connect Neon. In other tools each skill is one folder with a SKILL.md file, and you also need the Neon MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Neon. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.”
Download RevampKeyConnect Neon · 1 click
Get RevampKey to connect Neon
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Neon is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials branch-environment-cleanup migration-rollout query-performance-tuning schema-drift-review; do curl -fsSL --create-dirs -o .claude/skills/neon-$s/SKILL.md https://revampkey.com/marketplace/neon/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Neon MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials branch-environment-cleanup migration-rollout query-performance-tuning schema-drift-review; do
  curl -fsSL --create-dirs -o .claude/skills/neon-$s/SKILL.md https://revampkey.com/marketplace/neon/skills/$s/SKILL.md
done

Ask in plain language, for example “Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.”

Into the shared .agents/skills folder

Connect the Neon MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials branch-environment-cleanup migration-rollout query-performance-tuning schema-drift-review; do
  curl -fsSL --create-dirs -o .agents/skills/neon-$s/SKILL.md https://revampkey.com/marketplace/neon/skills/$s/SKILL.md
done

Ask in plain language, for example “Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.”

Into the shared .agents/skills folder

Connect the Neon MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials branch-environment-cleanup migration-rollout query-performance-tuning schema-drift-review; do
  curl -fsSL --create-dirs -o .agents/skills/neon-$s/SKILL.md https://revampkey.com/marketplace/neon/skills/$s/SKILL.md
done

Ask in plain language, for example “Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.”

Into the shared .agents/skills folder

Connect the Neon MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials branch-environment-cleanup migration-rollout query-performance-tuning schema-drift-review; do
  curl -fsSL --create-dirs -o .agents/skills/neon-$s/SKILL.md https://revampkey.com/marketplace/neon/skills/$s/SKILL.md
done

Ask in plain language, for example “Clean up the old preview branches in my Neon project 'storefront-api'. Show me what you would remove before deleting anything.”

RevampKey or copy the files?

In RevampKey

One click when you connect Neon
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Neon MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Neon skills FAQ

What is a Neon agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Neon skill describes one job, which Neon tools to use in which order, what to check first and when to stop and ask you.

Do the Neon skills change anything on their own?

1 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Neon.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Neon; elsewhere you copy the folders into your project or skills directory.

Do I need the Neon MCP server too?

Yes. The skills tell the agent how to do the work; the Neon MCP server gives it the tools to do it. The Neon MCP setup guide covers every client.

Neon MCP server setup · This page as Markdown

Put Neon’s best workflows in your agent

Download RevampKey, connect Neon and ask your first question in about a minute.

Download RevampKey Connect Neon · 1 click

All 5 Neon skills

Use Neon safely with AI

Use it when

Tools it uses

Clean up Neon branches and environments

Use it when

Tools it uses

Roll out a Neon schema migration safely

Use it when

Tools it uses

Tune a slow Neon query with AI

Use it when

Tools it uses

Review schema drift between Neon branches

Use it when

Tools it uses

Get all 5 without copying a file

How Neon skills work

How to install Neon skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Neon skills FAQ

Put Neon’s best workflows in your agent

Skills for related tools