Add skill for cluster and replication#26
Merged
Conversation
…ication Introduces skills/redis-clustering/ covering the two cluster-* rules from skills/redis-development/rules/ in agentskills.io spec layout: cluster-hash-tags → references/hash-tags.md cluster-read-replicas → references/read-replicas.md SKILL.md frames the skill around the two failure modes that bite most new cluster users: CROSSSLOT errors on multi-key operations (solved by hash tags) and overloading primaries with read traffic (solved by replica reads). Reference files carry the full Python and Java code samples. Additive only: the source cluster-*.md rules under skills/redis-development/ remain in place so the legacy compiled AGENTS.md continues to serve existing plugin consumers unchanged. They are removed in the final cleanup PR alongside the rest of the rules/ tree. Validation: - skill-validator check skills/redis-clustering → passed (0 warnings) - npm run validate → rules + plugin validators green Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
🛡️ Jit Security Scan Results✅ No security findings were detected in this PR
Security scan by Jit
|
Merged
pawelangelow
approved these changes
May 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Continues the agentskills.io migration of
redis-development's rules into focused spec-compliant skills (see #20–#25).This PR carves out the clustering and replication topic into its own skill so an agent has sharp triggers for "Redis Cluster", "hash tag", "CROSSSLOT", "read replica" instead of fishing through a 33-rule grab-bag.
Spec reference
SKILL.md+references/.What's in this PR
A single commit, additive only — no files deleted from
skills/redis-development/rules/. The legacyredis-developmentskill continues to include the twocluster-*rules unchanged, so downstream plugin consumers keep working through the migration. Duplicates are removed in the final cleanup PR.Two rules folded into `redis-clustering`:
SKILL.mdhas two sections, framed around the two failure modes that bite most new cluster users:{...}portion hashes to a slot;MGET/SDIFF/ pipelines / transactions need all keys on the same slot or they error out withCROSSSLOT. Includes the guidance to scope tags to the meaningful entity ({user:1001}) rather than bare identifiers ({1001}) that collide across namespaces.read_from_replicas=Truefor Redis Cluster and standalone replica setups, with the eventually-consistent caveat made concrete: fine for caches / analytics / dashboards, not for balances or idempotency state.Validation
skill-validator check skills/redis-clustering→ passed, 0 warnings.npm run validate→ rules, claude-plugins, cursor-plugins all green.Out of scope (follow-ups)
cluster-*.mdsource rules — happens in the final cleanup PR.🤖 Generated with Claude Code
Note
Low Risk
Low risk because this PR is additive documentation/content only and does not change runtime code paths or behavior.
Overview
Introduces a new spec-compliant
redis-clusteringskill (SKILL.md+references/) that consolidates Redis Cluster key-design guidance around hash tags for multi-key operations (avoidingCROSSSLOTerrors in pipelines/transactions/scripts) and routing reads to replicas for read-heavy workloads, including the eventual-consistency caveats.Adds two standalone reference docs (
references/hash-tags.md,references/read-replicas.md) with concrete Python/Java examples and links to official Redis docs.Reviewed by Cursor Bugbot for commit d6e6f4b. Bugbot is set up for automated code reviews on this repo. Configure here.