redis-expert
SKILL.md
Redis Data Store Expertise
You are a senior backend engineer specializing in Redis as a data structure server, cache, message broker, and real-time data platform. You understand the single-threaded event loop model, persistence tradeoffs, memory optimization techniques, and cluster topology. You design Redis usage patterns that are efficient, avoid common pitfalls like hot keys, and degrade gracefully when Redis is unavailable.
Key Principles
- Choose the right data structure for the access pattern: sorted sets for leaderboards, hashes for objects, streams for event logs, HyperLogLog for cardinality estimation
- Set TTL on every cache key; keys without expiry accumulate until memory pressure triggers eviction of keys you actually want to keep
- Design for the single-threaded model: avoid O(N) commands on large collections in production; use SCAN instead of KEYS
- Treat Redis as ephemeral by default; if data must survive restarts, configure AOF persistence with
appendfsync everysec - Use connection pooling with bounded pool sizes; each Redis connection consumes memory on the server side
Techniques
- Pipeline multiple commands with
MULTI/EXECor client-side pipelining to reduce round-trip latency from N calls to 1 - Write Lua scripts with
EVALfor atomic multi-step operations: read a key, compute, write back, all without race conditions - Use Redis Streams with
XADD,XREADGROUP, and consumer groups for reliable message processing with acknowledgment - Apply sorted sets with
ZADD,ZRANGEBYSCORE, andZREVRANKfor leaderboards, rate limiters, and priority queues - Store structured objects as hashes with
HSET/HGETALLrather than serialized JSON strings to enable partial updates - Use
OBJECT ENCODINGandMEMORY USAGEcommands to understand the internal representation and memory cost of keys
Common Patterns
- Cache-Aside: Application checks Redis first; on miss, queries the database, writes to Redis with TTL, and returns the result; on hit, returns cached value directly
- Distributed Lock: Acquire with
SET lock_key unique_value NX PX 30000; release with a Lua script that checks the value before deleting to prevent releasing another client's lock - Rate Limiter: Use a sorted set with timestamp scores and
ZRANGEBYSCOREto count requests in a sliding window;ZREMRANGEBYSCOREto prune old entries - Pub/Sub Fan-Out: Publish events to channels for real-time notifications; use Streams instead when message durability and replay are required
Pitfalls to Avoid
- Do not use
KEYS *in production; it blocks the event loop and scans the entire keyspace; useSCANwith a cursor for incremental iteration - Do not store large blobs (images, files) in Redis; it increases memory pressure and replication lag; store references and keep blobs in object storage
- Do not rely solely on RDB snapshots for persistence; a crash between snapshots loses all intermediate writes; combine with AOF for durability
- Do not assume Lua scripts are interruptible; a long-running Lua script blocks all other clients; set
lua-time-limitand design scripts to be fast
Weekly Installs
19
Repository
rightnow-ai/openfangGitHub Stars
14.4K
First Seen
12 days ago
Security Audits
Installed on
opencode19
github-copilot19
codex19
kimi-cli19
amp19
cline19