# redis-clustering

> Claude/Codex skill by [@redis](https://omgskills.com/library/redis/index.md) · 169 stars · Updated 2026-09-08

Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads. Use when designing keys for a sharded Redis Cluster, debugging CROSSSLOT errors on MGET / SDIFF / pipelines, configuring a multi-key transaction in a cluster, or routing reads to replicas for caches, analytics, or dashboards.

Tags: agent-skills, redis

## Install

```sh
git clone https://github.com/redis/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/redis-clustering ~/.claude/skills/redis-clustering
```

## From README

Redis Clustering Guidance for designing keys and routing reads in a sharded Redis Cluster (and in standalone primary/replica replication). Covers the two failure modes that bite most new cluster users: CROSSSLOT errors on multi-key operations, and overloading primaries with read traffic. When to apply Designing keys for a Redis Cluster deployment. Debugging a CROSSSLOT error on MGET, SDIFF, transactions, or pipelines. Implementing transactions / Lua scripts that touch multiple keys. Scaling out read traffic without adding shards. Hash tags for multi-key operations Redis Cluster distributes keys across 16,384 slots by hashing the key name. Any command that touches multiple keys (MGET, SDIFF, SUNIONSTORE, transactions, pipelines, Lua scripts with multiple KEYS\[\]) requires all keys to live on the same slot — otherwise the server returns a CROSSSLOT error.

## Links

- HTML page: https://omgskills.com/library/redis/agent-skills/skills/redis-clustering/
- GitHub: https://github.com/redis/agent-skills
- Author: [@redis](https://omgskills.com/library/redis/index.md)

## More from this repo

- [iris-development](https://omgskills.com/library/redis/agent-skills/skills/iris-development/index.md) — Iris is Redis's umbrella for AI-focused products.
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars
- [redis-connections](https://omgskills.com/library/redis/agent-skills/skills/redis-connections/index.md) — Redis client and connection guidance covering connection pooling, multiplexing, pipelining, client-side caching with...
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars
- [redis-observability](https://omgskills.com/library/redis/agent-skills/skills/redis-observability/index.md) — Redis observability guidance — which metrics to monitor (memory, connections, hit ratio, ops/sec, rejected...
   - [@redis](https://omgskills.com/library/redis/index.md) · 169 stars
