redis-clustering

Guide Redis cluster design with hash-tagging and replica read routing.

94|22|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/redis/agent-skills --skill redis-clustering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: redis-clustering
Source: https://github.com/redis/agent-skills/tree/main/skills/redis-clustering
Command: npx skills add https://github.com/redis/agent-skills --skill redis-clustering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Redis clustering guidance for hash-tagging and read scaling to avoid CROSSSLOT errors and overloaded primaries; designed for developers implementing sharded Redis deployments and need practical debugging guidance.

Core Features & Use Cases

  • Hash-tag based key design for multi-key operations in clusters.
  • Read replica routing to scale reads in cluster and non-cluster setups.
  • Troubleshooting and debugging cross-slot issues in MGET, SDIFF, transactions, and pipelines.

Quick Start

Design keys using hash tags for multi-key operations and enable replica reads to scale read workloads.

Frequently Asked Questions about redis-clustering

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do I get CROSSSLOT errors during multi-key operations in a Redis cluster?

CROSSSLOT errors occur when multi-key commands like MGET or SDIFF target keys hashed to different cluster slots. You resolve this by designing keys with hash tags, ensuring all keys map to the same slot for safe multi-key operations.

How do I use hash tags to group keys in a Redis cluster?

Hash tags group keys by wrapping a substring in curly braces, forcing the cluster to hash only that substring. This ensures keys map to the same slot, enabling multi-key transactions and pipelines without cross-slot limitations.

Can I route read-heavy workloads to replicas in a clustered Redis setup?

Yes, you can scale read-heavy workloads by routing read commands to replicas. This reduces primary node overload and improves overall cluster scalability in both clustered and non-clustered replica configurations.

Does Redis clustering support multi-key transactions across different slots?

Redis clustering does not support multi-key transactions across different slots. You must use hash tags to force keys onto the same slot before executing transactions, MGET, SDIFF, or pipelines successfully.

What is the best way to troubleshoot cross-slot issues in Redis pipelines?

Troubleshooting cross-slot issues in Redis pipelines requires verifying key hashing distribution. You apply hash tags to align multi-key operations to a single slot, resolving errors and stabilizing pipeline execution.