New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Official agent skill

Redis Clustering

by redis in redis/agent-skills

Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads.

OfficialMITAuto-check passedDatabases

Install Redis Clustering

skills CLI
$ npx skills add redis/agent-skills --skill redis-clustering -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install redis/agent-skills redis-clustering --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/redis/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/redis-clustering .claude/skills/redis-clustering && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
redis-clustering
GitHub stars
165
Used in
1 other repo
Token cost
~1k tokens
SKILL.md length
326 words
Files
3 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads.

  • Works in 2 steps: Hash tags for multi-key operations → Read replicas for read-heavy workloads
  • Designing keys for a sharded Redis Cluster
  • SKILL.md covers When to apply, 1. Hash tags for multi-key…, 2. Read replicas for… and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Redis Clustering is an agent skill from redis/agent-skills, published by the product's own GitHub organization. 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.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/hash-tags.md` and `references/read-replicas.md`).

It sits in Databases, covering Database administration. It works with Redis. The repository describes itself as: Redis' official collection of agent skills. The licence is MIT.

When your agent uses it

  • Designing keys for a sharded Redis Cluster
  • Debugging CROSSSLOT errors on MGET / SDIFF / pipelines
  • Configuring a multi-key transaction in a cluster
  • Routing reads to replicas for caches

Example prompts

  • “/redis-clustering”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Hash tags for multi-key operations
  2. Read replicas for read-heavy workloads

What it can do on your machine

Read from SKILL.md and the folder at commit a84871d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • redis.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Redis Clustering loads about 1k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 326 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from redis/agent-skills at commit a84871d, republished under its MIT licence (© redis). 326 words, ~1,031 tokens.

Download SKILL.mdSave it as .claude/skills/redis-clustering/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
redis-clustering
description
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.
license
MIT
metadata.author
Redis, Inc.
metadata.version
0.1.0

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.

1. 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.

Hash tags force this: the part between { and } is the only thing hashed for slot assignment, so two keys sharing a hash tag always land together.

python
# Same slot — multi-key ops work
redis.set("{user:1001}:profile",  "...")
redis.set("{user:1001}:settings", "...")
redis.lmove("{user:1001}:pending", "{user:1001}:processed", "LEFT", "RIGHT")
python
# Different keys, no hash tag — CROSSSLOT on multi-key commands in cluster mode
redis.set("user:1001:profile",  "...")
redis.set("user:1001:settings", "...")
pipe = redis.pipeline()
pipe.get("user:1001:profile")
pipe.get("user:1001:settings")
pipe.execute()  # CROSSSLOT error in cluster

Rules of thumb:

  • Use a tag scoped to the meaningful entity, e.g. {user:1001}. Avoid bare {1001} — unrelated namespaces (purchase:{1001}, employee:{1001}) would all collide on the same slot.
  • Only tag where you actually need multi-key ops. Tagging everything creates hotspots and defeats the point of sharding.
  • A single-key command on a hash-tagged key works fine, so adding tags later is incremental — but renaming keys in production is painful, so plan tagging up front for entities you'll group.

See references/hash-tags.md.

2. Read replicas for read-heavy workloads

If reads dominate writes, route them to replicas to free primary capacity. Works both in Redis Cluster (each shard has 1+ replica) and in standalone primary/replica replication.

python
# Redis Cluster: enable replica reads on the client
from redis.cluster import RedisCluster

rc = RedisCluster(host="localhost", port=6379, read_from_replicas=True)
rc.set("key", "value")     # → primary
value = rc.get("key")       # → may be served by a replica

For non-cluster setups, point two clients at the right nodes:

python
primary = Redis(host="primary-host", port=6379)
replica = Redis(host="replica-host", port=6379)
primary.set("key", "value")
value = replica.get("key")

The trade-off is consistency: replicas are eventually consistent. Don't read your own writes from a replica; don't use replica reads for anything that requires strict freshness (financial balances, idempotency state). Good fits: cache layers, analytics, dashboards, recommendation feeds.

See references/read-replicas.md.

References

© redis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/redis-clustering of redis/agent-skills.

  • SKILL.md
  • references/hash-tags.md
  • references/read-replicas.md

Open the folder on GitHubat commit a84871d

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in redis/agent-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Redis Clustering next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Redis Clustering compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Redis Clustering this skillredis/agent-skills1651 repos~1kAutomated safety check: PassMIT
Mail Timeveliovgroup/mail-time143—~1kAutomated safety check: PassBSD-3-Clause
AWS Cloudformation Elasticachegiuseppe-trisciuoglio/developer-kit356—~1.5kAutomated safety check: NotesMIT
Redis Inspectorevolution-foundation/evo-nexus545—~1.3kAutomated safety check: NotesCustom licence
Discover Databaserand/cc-polymath181—~2kAutomated safety check: PassMIT
Azure Resource Manager Redis Dotnetmicrosoft/skills3.1k5 repos~3kAutomated safety check: PassMIT

Similar skills

  • Mail Time

    veliovgroup/mail-time

    A skill your agent uses when building, wiring, reviewing, or debugging MailTime and ostrio:mailer email queues for horizontally scaled Node.js, Bun, or Meteor apps.

    143 GitHub stars~1k tokensUpdated yesterday
    DatabasesAuto-check passed

  • AWS Cloudformation Elasticache

    giuseppe-trisciuoglio/developer-kit

    Provides AWS CloudFormation patterns for ElastiCache Redis or Memcached infrastructure, including subnet groups, parameter groups, security controls, and cross-stack outputs.

    356 GitHub stars~1.5k tokensUpdated 28 days ago
    DatabasesAuto-check: notes

  • Redis Inspector

    evolution-foundation/evo-nexus

    Reads keys and server state from Redis instances configured in .env through a read-only Python client, choosing connections by label or index.

    545 GitHub stars~1.3k tokensUpdated 4 mo ago
    DatabasesAuto-check: notes

  • Discover Database

    rand/cc-polymath

    Automatically discover database skills when working with SQL, PostgreSQL, MongoDB, Redis, database schema design, query optimization, migrations, connection pooling, ORMs, or database selection.

    181 GitHub stars~2k tokensUpdated 7 mo ago
    DatabasesAuto-check passed

  • Azure Resource Manager Redis Dotnet

    microsoft/skills

    Official

    Azure Resource Manager SDK for Redis in .NET. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 5 repos~3k tokens
    DatabasesAuto-check passed

  • Azure Managed Redis

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Managed Redis development including troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, integrations & coding…

    777 GitHub stars~3.4k tokensUpdated 3 days ago
    DatabasesAuto-check passed

More from redis/agent-skills

All 8 skills in this repo

  • Redis Core

    redis/agent-skills

    Official

    Core Redis modeling guidance — choose the right data structure (String, Hash, List, Set, Sorted Set, JSON, Stream, Vector Set) and use consistent colon-separated key names.

    165 GitHub starsUsed in 2 repos~759 tokens
    Auto-check passed

  • Redis Observability

    redis/agent-skills

    Official

    Redis observability guidance — which metrics to monitor (memory, connections, hit ratio, ops/sec, rejected connections), which built-in commands to reach for during incident triage (SLOWLOG, INFO…

    165 GitHub starsUsed in 2 repos~911 tokens
    Auto-check passed

  • Redis Connections

    redis/agent-skills

    Official

    Redis client and connection guidance covering connection pooling, multiplexing, pipelining, client-side caching with RESP3, avoiding slow commands (KEYS, SMEMBERS, HGETALL), and tuning socket…

    165 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

  • Redis Search

    redis/agent-skills

    Official

    Redis Search guidance covering FT.CREATE schema design, field type selection (TEXT, TAG, NUMERIC, GEO, GEOSHAPE, VECTOR, JSON path), DIALECT 2 query syntax, FT.SEARCH / FT.AGGREGATE / FT.HYBRID…

    165 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed

  • Redis Security

    redis/agent-skills

    Official

    Redis security guidance covering authentication (requirepass and ACL users), TLS, ACL-based least-privilege access control, restricting network exposure via bind and protected-mode, firewall rules…

    165 GitHub starsUsed in 1 repo~918 tokens
    Auto-check passed

  • Iris Development

    redis/agent-skills

    Official

    Iris is Redis's umbrella for AI-focused products. An agent skill from redis/agent-skills.

    165 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Redis Clustering

What does Redis Clustering do?

Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads. Redis Clustering is an agent skill from redis/agent-skills, published by the product's own GitHub organization. Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads.

When should I use Redis Clustering?

Redis Clustering fits situations like: designing keys for a sharded Redis Cluster; debugging CROSSSLOT errors on MGET / SDIFF / pipelines; configuring a multi-key transaction in a cluster; routing reads to replicas for caches.

How do I install Redis Clustering in Claude Code?

Run `npx skills add redis/agent-skills --skill redis-clustering -a claude-code`. Or copy the skill folder (skills/redis-clustering in redis/agent-skills) into .claude/skills/redis-clustering in your project. Claude Code loads it when a task matches its description.

How do I install Redis Clustering in Codex?

Run `npx skills add redis/agent-skills --skill redis-clustering -a codex`. Or copy the skill folder (skills/redis-clustering in redis/agent-skills) into .agents/skills/redis-clustering in your project. Codex loads it when a task matches its description.

Can I use Redis Clustering in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add redis/agent-skills --skill redis-clustering -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/redis-clustering, .gemini/skills/redis-clustering, .github/skills/redis-clustering and .opencode/skills/redis-clustering in your project.

What does Redis Clustering need to run?

SKILL.md names no scripts, command-line tools or credentials: Redis Clustering is instructions for the agent only. Our summary lists: Python 3.

Does Redis Clustering access the network?

SKILL.md names 1 domain. As links in the text: redis.io. This is read from the text; nothing was executed.

Is Redis Clustering safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Redis Clustering use?

Redis Clustering is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Redis Clustering use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 935 tokens, read only when the agent opens those files.

What are the alternatives to Redis Clustering?

Skills that share tags, products or a category with Redis Clustering: Mail Time (veliovgroup/mail-time, 143 stars), AWS Cloudformation Elasticache (giuseppe-trisciuoglio/developer-kit, 356 stars), Redis Inspector (evolution-foundation/evo-nexus, 545 stars) and Discover Database (rand/cc-polymath, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Redis Clustering?

redis (a GitHub organization, an official publisher) maintains it in redis/agent-skills, which has 165 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 8, 2026.

Source: redis/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.