PlanetScale agent skills for Claude Code, Cursor and RevampKey

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

Download RevampKey, free I have it: connect PlanetScale

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

All 4 PlanetScale skills

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

Start hereRead-only15 PlanetScale tools

Use PlanetScale with AI, safely

Pins down the organization, database and branch before reading, picks the narrowest PlanetScale tool, and asks for explicit approval before any write query runs.

Use it when

You connected PlanetScale to an AI assistant and want to know what it can safely do
An assistant is about to query a database and you want it to confirm the branch first
A query was refused because of access settings and you want to know why

Tools it uses

planetscale_list_organizations
planetscale_list_databases
planetscale_list_branches
planetscale_get_branch_schema
planetscale_get_organization
planetscale_get_database
planetscale_get_branch
planetscale_get_insights
planetscale_execute_read_query
planetscale_list_invoices
planetscale_get_invoice_line_items
planetscale_search_documentation
planetscale_list_cluster_size_skus
planetscale_list_regions_for_organization
planetscale_execute_write_query

Example

Check the orders table on our production branch and tell me how many rows it has.

I'll confirm first: organisation Acme, database shop, production branch. Reading the orders table with a bounded count query now. It has 48,213 rows. I did not change anything.

Use in RevampKeyRead the full skill →

Read-only11 PlanetScale tools

Audit your PlanetScale bill with AI

Breaks a PlanetScale invoice into its line items, groups the charges by database, branch and cluster size, and flags spend that looks unexpected or idle. It only reads billing data and never changes your payment method or plan.

Use it when

Your PlanetScale bill went up and you want to know why
You want to see which database or branch costs the most
You are looking for idle capacity to reduce before the next invoice

Tools it uses

planetscale_list_organizations
planetscale_list_invoices
planetscale_get_invoice_line_items
planetscale_list_databases
planetscale_list_branches
planetscale_get_branch
planetscale_get_database
planetscale_list_cluster_size_skus
planetscale_list_regions_for_organization
planetscale_get_insights
planetscale_get_branch_schema

Example

Why did our PlanetScale bill go up this month, and which branch is the biggest cost?

Your latest invoice for the production organization is $1,240, up $310 on last month's $930. Most of the increase comes from one large cluster on the analytics database, which was added mid-period and accounts for $260 of the change. A preview branch on the orders database has been running at a large size since March with little activity, which I'd flag for you to check. I haven't changed anything; deleting or resizing either would be your call.

Use in RevampKeyRead the full skill →

Read-only4 PlanetScale tools

Review a PlanetScale branch's schema with AI

Reviews a branch's schema for missing keys, indexes, risky column types and unsafe migration steps, using read-only queries to check the data. It asks before changing anything.

Use it when

Before merging a feature branch that changes tables
When a new table design needs a sanity check before it reaches production
When you suspect a migration will lock or break a populated table

Tools it uses

planetscale_get_branch_schema
planetscale_get_branch
planetscale_execute_read_query
planetscale_execute_write_query

Example

Review the schema on the add-invoices branch before I merge it into main.

Verdict: ready with fixes. Blocking: the new invoice_items table has no index on invoice_id, which every invoice lookup filters on. Adding customer_ref as NOT NULL will fail on the existing table because 12 rows have no value. Read-only checks found 12 null values in orders.customer_ref out of 4,380 rows.

Use in RevampKeyRead the full skill →

Read-only9 PlanetScale tools

Find and fix slow PlanetScale queries

Ranks your slowest and most expensive queries from Insights, checks index recommendations against the real schema, and confirms causes with read-only queries. It proposes changes and waits for your approval before writing anything.

Use it when

A PlanetScale database has become slow after a release
You want to know which queries use the most total time
You need to decide which indexes are worth adding

Tools it uses

planetscale_list_organizations
planetscale_list_databases
planetscale_get_database
planetscale_list_branches
planetscale_get_branch
planetscale_get_insights
planetscale_get_branch_schema
planetscale_execute_read_query
planetscale_execute_write_query

Example

Why is the orders database slow this afternoon? Show me the top queries and whether an index would help.

The top query runs about 480,000 times an hour, averaging 35 ms and examining roughly 9,000 rows to return 12. It filters orders by customer_id, and the plan shows a full scan because the index on customer_id was dropped in last week's migration. I propose recreating it on the production branch through a deploy request. I have made no changes yet and will wait for your explicit yes.

Use in RevampKeyRead the full skill →

Get all 4 without copying a file

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

Download RevampKey

How PlanetScale skills work

Connect PlanetScale
The PlanetScale MCP server gives the agent its tools.
Ask in plain words
“Why did our PlanetScale bill go up this month, and which branch is the biggest cost?” 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 PlanetScale skills

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

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect PlanetScale. All 4 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Why did our PlanetScale bill go up this month, and which branch is the biggest cost?”
Download RevampKeyConnect PlanetScale · 1 click
Get RevampKey to connect PlanetScale
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and PlanetScale is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials cost-and-invoice-audit database-schema-review query-performance-insights; do curl -fsSL --create-dirs -o .claude/skills/planetscale-$s/SKILL.md https://revampkey.com/marketplace/planetscale/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the PlanetScale MCP server in Claude Code.

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

for s in essentials cost-and-invoice-audit database-schema-review query-performance-insights; do
  curl -fsSL --create-dirs -o .claude/skills/planetscale-$s/SKILL.md https://revampkey.com/marketplace/planetscale/skills/$s/SKILL.md
done

Ask in plain language, for example “Why did our PlanetScale bill go up this month, and which branch is the biggest cost?”

Into the shared .agents/skills folder

Connect the PlanetScale MCP server in Cursor.

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

for s in essentials cost-and-invoice-audit database-schema-review query-performance-insights; do
  curl -fsSL --create-dirs -o .agents/skills/planetscale-$s/SKILL.md https://revampkey.com/marketplace/planetscale/skills/$s/SKILL.md
done

Ask in plain language, for example “Why did our PlanetScale bill go up this month, and which branch is the biggest cost?”

Into the shared .agents/skills folder

Connect the PlanetScale MCP server in Codex.

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

for s in essentials cost-and-invoice-audit database-schema-review query-performance-insights; do
  curl -fsSL --create-dirs -o .agents/skills/planetscale-$s/SKILL.md https://revampkey.com/marketplace/planetscale/skills/$s/SKILL.md
done

Ask in plain language, for example “Why did our PlanetScale bill go up this month, and which branch is the biggest cost?”

Into the shared .agents/skills folder

Connect the PlanetScale MCP server in VS Code.

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

for s in essentials cost-and-invoice-audit database-schema-review query-performance-insights; do
  curl -fsSL --create-dirs -o .agents/skills/planetscale-$s/SKILL.md https://revampkey.com/marketplace/planetscale/skills/$s/SKILL.md
done

Ask in plain language, for example “Why did our PlanetScale bill go up this month, and which branch is the biggest cost?”

RevampKey or copy the files?

In RevampKey

One click when you connect PlanetScale
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 PlanetScale MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

PlanetScale skills FAQ

What is a PlanetScale agent skill?

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

Do the PlanetScale skills change anything on their own?

4 of the 4 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 PlanetScale.

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 PlanetScale; elsewhere you copy the folders into your project or skills directory.

Do I need the PlanetScale MCP server too?

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

PlanetScale MCP server setup · This page as Markdown

Put PlanetScale’s best workflows in your agent

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

Download RevampKey Connect PlanetScale · 1 click

All 4 PlanetScale skills

Use PlanetScale with AI, safely

Use it when

Tools it uses

Audit your PlanetScale bill with AI

Use it when

Tools it uses

Review a PlanetScale branch's schema with AI

Use it when

Tools it uses

Find and fix slow PlanetScale queries

Use it when

Tools it uses

Get all 4 without copying a file

How PlanetScale skills work

How to install PlanetScale skills

RevampKey or copy the files?

In RevampKey

Copy into your project

PlanetScale skills FAQ

Put PlanetScale’s best workflows in your agent

Skills for related tools