# Neon agent skills for Claude Code, Cursor and RevampKey

> Ready-made Neon playbooks for AI agents: clean up Neon branches and environments, roll out a Neon schema migration safely, tune a slow Neon query with AI. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use Neon safely with AI](https://revampkey.com/marketplace/neon/skills/essentials.md): 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.
- [Clean up Neon branches and environments](https://revampkey.com/marketplace/neon/skills/branch-environment-cleanup.md): 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.
- [Roll out a Neon schema migration safely](https://revampkey.com/marketplace/neon/skills/migration-rollout.md): 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.
- [Tune a slow Neon query with AI](https://revampkey.com/marketplace/neon/skills/query-performance-tuning.md): 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.
- [Review schema drift between Neon branches](https://revampkey.com/marketplace/neon/skills/schema-drift-review.md): 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.

## Install

- RevampKey: connect Neon at https://revampkey.com/marketplace/neon; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
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
```

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

MCP setup guide: https://revampkey.com/marketplace/neon.md