# PlanetScale agent skills for Claude Code, Cursor and RevampKey

> Ready-made PlanetScale playbooks for AI agents: audit your PlanetScale bill with AI, review a PlanetScale branch's schema with AI, find and fix slow PlanetScale queries. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use PlanetScale with AI, safely](https://revampkey.com/marketplace/planetscale/skills/essentials.md): Pins down the organization, database and branch before reading, picks the narrowest PlanetScale tool, and asks for explicit approval before any write query runs.
- [Audit your PlanetScale bill with AI](https://revampkey.com/marketplace/planetscale/skills/cost-and-invoice-audit.md): 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.
- [Review a PlanetScale branch's schema with AI](https://revampkey.com/marketplace/planetscale/skills/database-schema-review.md): 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.
- [Find and fix slow PlanetScale queries](https://revampkey.com/marketplace/planetscale/skills/query-performance-insights.md): 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.

## Install

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

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

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

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