planetscale / database-skills
✓ Official★ 530A skill package that teaches your agent 4 capabilities — every one documented and browsable below, no GitHub required · by PlanetScale.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations. Use when creating or modifying MySQL tables, indexes, or queries; diagnosing slow/locking behavior; planning migrations; or troubleshooting replication and connection issues. Load when using a MySQL database.
20 files — installable on its own
Overview and information about Neki, the sharded Postgres product by PlanetScale. Load when working with Neki-related tasks and the need to scale or shard…
3 files — installable on its own
PostgreSQL best practices, query optimization, connection troubleshooting, and performance improvement. Load when working with Postgres databases.
24 files — installable on its own
Vitess best practices, query optimization, and connection troubleshooting for PlanetScale Vitess databases. Load when working with Vitess databases, sharding,…
7 files — installable on its own
Database Skills
Database-focused skills for AI coding assistants. Each skill lives in its own sub-directory under skills/ and covers a specific database technology.
Installation
skills.sh
npx skills add planetscale/database-skillsSee skills.sh for more info.
Cursor plugin
In Cursor chat, add this repository as a plugin:
/add-plugin database-skillsAvailable Skills
mysql
Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations. Use when creating or modifying MySQL tables, indexes, or queries; diagnosing slow or locking behavior; planning migrations; or troubleshooting replication and connection issues.
neki
Overview and guidance for Neki, PlanetScale's sharded Postgres product. Use when working with Neki-related tasks or evaluating how to scale and shard Postgres.
postgres
PostgreSQL best practices, query optimization, connection troubleshooting, and performance insights for PlanetScale Postgres. Use when working with PlanetScale PostgreSQL databases — schema design, indexing, MVCC/VACUUM, WAL tuning, replication, monitoring, or PlanetScale-specific features like connection pooling and CLI insights.
vitess
Vitess best practices, query optimization, and connection troubleshooting for PlanetScale Vitess databases. Use when working with sharding, VSchema configuration, keyspace management, online DDL, VReplication, or MySQL-compatible scaling issues.
Repo Structure
database-skills/
├── .cursor-plugin/
│ └── plugin.json
├── README.md
└── skills/
├── mysql/
│ ├── SKILL.md
│ └── references/
├── neki/
│ ├── SKILL.md
│ └── references/
├── postgres/
│ ├── SKILL.md
│ └── references/
└── vitess/
├── SKILL.md
└── references/Each skill is a sub-directory under skills/ containing:
- SKILL.md — Required. Instructions, triggers, and workflow for the skill.
- references/ — Optional. Supporting documents loaded into context as needed.
Contributing
- Fork this repo
- Create a new skill directory under
skills/ - Add a
SKILL.mdand optionalreferences/ - Submit a PR
Install the whole package (4 skills):
npx skills add https://github.com/planetscale/database-skillsOr install a single skill:
npx skills add https://github.com/planetscale/database-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.