# neki

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

Guidance for Neki, PlanetScale's distributed (sharded) Postgres. Load when working with a Neki database — connecting, data topology and shard keys, query routing and fanout, cross-shard transactions, schema changes, resharding and migration, NK013 errors — or when scaling and sharding Postgres.

## Install

```sh
git clone https://github.com/planetscale/database-skills /tmp/database-skills && ln -s /tmp/database-skills/skills/neki ~/.claude/skills/neki
```

## From README

PlanetScale Neki Docs: https://planetscale.com/docs/neki · https://neki.dev/ Platform Preview: Neki is in PlanetScale Platform Preview (a Beta Feature under the PlanetScale Terms of Service; no SLA). Single-instance, non-HA configurations are not supported during the preview. See Platform preview limitations. Overview Neki is distributed (sharded) Postgres by PlanetScale. Every shard is real Postgres; Neki places a router in front of the shards and adds per-instance sidecars and a control plane (topology service, admin, Replicator) to route, coordinate, and operate Postgres across many shards — all behind one Postgres connection string on port 5432. Applications use standard Postgres clients, drivers, and ORMs. Neki is built by the maintainers of Vitess but is a from-scratch system for Postgres, not a Vitess port.

## Links

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

## More from this repo

- [mysql](https://omgskills.com/skills/planetscale/database-skills/mysql/index.md) — Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations.
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 717 stars
- [postgres](https://omgskills.com/skills/planetscale/database-skills/postgres/index.md) — PostgreSQL best practices, query optimization, connection troubleshooting, and performance improvement.
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 717 stars
- [vitess](https://omgskills.com/skills/planetscale/database-skills/vitess/index.md) — Vitess best practices, query optimization, and connection troubleshooting for PlanetScale Vitess databases.
   - [@planetscale](https://omgskills.com/library/planetscale/index.md) · 717 stars