# planetscale-best-practices-matrix

> Claude/Codex skill by [@planetscale](https://omgskills.com/library/planetscale/index.md) · 134 stars · Updated 2026-10-16

A concise feature matrix for deciding which PlanetScale safety, observability, and automation recommendations apply by engine.

## Install

```sh
git clone https://github.com/planetscale/skills /tmp/skills && ln -s /tmp/skills/planetscale-best-practices-matrix ~/.claude/skills/planetscale-best-practices-matrix
```

## From README

Best-practices matrix Purpose Map database findings to recommended PlanetScale features. Use this to ensure the assessment does not miss major safety and operational surfaces. Cross-engine recommendations Query Insights Recommend for every production database: Review slow, expensive, high-frequency, and erroring query patterns. For Postgres, sort Insights by CPU (sort=cpuTime on the Insights API) when diagnosing CPU pressure. For sharded Vitess, review vindex per query pattern and the trend after index or routing changes. Correlate regressions with deploys. Use tags/comments to map queries back to code. Use tag filtering/navigation in Query Insights: the tags API (insights/tags, insights/tags/summaries) on both engines, plus tag:key:value filtering and per-execution tag drill-down in the Vitess dashboard. Use anomalies as alert and automation inputs. Webhooks Recommend for operational events: Anomalies. Storage pressure. Branch readiness/sleeping. Primary promotion. Maintenance.

## Links

- HTML page: https://omgskills.com/library/planetscale/skills/planetscale-best-practices-matrix/
- GitHub: https://github.com/planetscale/skills
- Author: [@planetscale](https://omgskills.com/library/planetscale/index.md)

## More from this repo

- [planetscale-autonomous-execution-mode](https://omgskills.com/library/planetscale/skills/planetscale-autonomous-execution-mode/index.md) — Execute approved PlanetScale changes end-to-end without per-step approval when the operator has explicitly acknowledged...
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 134 stars
- [planetscale-change-gates-and-approval-contract](https://omgskills.com/library/planetscale/skills/planetscale-change-gates-and-approval-contract/index.md) — Enforce explicit approval gates for any PlanetScale, database, repository, credential, network, or automation mutation.
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 134 stars
- [planetscale-codebase-sqlcommenter-instrumentation](https://omgskills.com/library/planetscale/skills/planetscale-codebase-sqlcommenter-instrumentation/index.md) — Inspect an application repository connected to PlanetScale and recommend SQLCommenter-compatible query tagging packages...
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 134 stars