redis/redis-development
skills/redis-development/SKILL.md
Redis performance optimization and best practices. Use this skill when working with Redis data structures, Redis Query Engine (RQE), vector search with RedisVL, semantic caching with LangCache, or optimizing Redis performance.
$ install --global
skillsauthnpx skillsauth add redis/agent-skills redis-developmentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 23, 2026, 5:52 AM80.3s49 files scanned
SKILL.md
- name:
- redis-development
- description:
- Redis performance optimization and best practices. Use this skill when working with Redis data structures, Redis Query Engine (RQE), vector search with RedisVL, semantic caching with LangCache, or optimizing Redis performance.
- license:
- MIT
- author:
- redis
- version:
- 1.0.0
Redis Best Practices
Comprehensive performance optimization guide for Redis, including Redis Query Engine, vector search, and semantic caching. Contains 29 rules across 11 categories, prioritized by impact to guide automated optimization and code generation.
When to Apply
Reference these guidelines when:
- Designing Redis data models and key structures
- Implementing caching, sessions, or real-time features
- Using Redis Query Engine (FT.CREATE, FT.SEARCH, FT.AGGREGATE)
- Building vector search or RAG applications with RedisVL
- Implementing semantic caching with LangCache
- Optimizing Redis performance and memory usage
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Data Structures & Keys | HIGH | data- |
| 2 | Memory & Expiration | HIGH | ram- |
| 3 | Connection & Performance | HIGH | conn- |
| 4 | JSON Documents | MEDIUM | json- |
| 5 | Redis Query Engine | HIGH | rqe- |
| 6 | Vector Search & RedisVL | HIGH | vector- |
| 7 | Semantic Caching | MEDIUM | semantic-cache- |
| 8 | Streams & Pub/Sub | MEDIUM | stream- |
| 9 | Clustering & Replication | MEDIUM | cluster- |
| 10 | Security | HIGH | security- |
| 11 | Observability | MEDIUM | observe- |
Quick Reference
1. Data Structures & Keys (HIGH)
data-choose-structure- Choose the Right Data Structuredata-key-naming- Use Consistent Key Naming Conventions
2. Memory & Expiration (HIGH)
ram-limits- Configure Memory Limits and Eviction Policiesram-ttl- Set TTL on Cache Keys
3. Connection & Performance (HIGH)
conn-blocking- Avoid Slow Commands in Productionconn-pipelining- Use Pipelining for Bulk Operationsconn-pooling- Use Connection Pooling or Multiplexingconn-timeouts- Configure Connection Timeouts
4. JSON Documents (MEDIUM)
json-partial-updates- Use JSON Paths for Partial Updatesjson-vs-hash- Choose JSON vs Hash Appropriately
5. Redis Query Engine (HIGH)
rqe-dialect- Use DIALECT 2 for Query Syntaxrqe-field-types- Choose the Correct Field Typerqe-index-creation- Index Only Fields You Queryrqe-index-management- Manage Indexes for Zero-Downtime Updatesrqe-query-optimization- Write Efficient Queries
6. Vector Search & RedisVL (HIGH)
vector-algorithm-choice- Choose HNSW vs FLAT Based on Requirementsvector-hybrid-search- Use Hybrid Search for Better Resultsvector-index-creation- Configure Vector Indexes Properlyvector-rag-pattern- Implement RAG Pattern Correctly
7. Semantic Caching (MEDIUM)
semantic-cache-best-practices- Configure Semantic Cache Properlysemantic-cache-langcache-usage- Use LangCache for LLM Response Caching
8. Streams & Pub/Sub (MEDIUM)
stream-choosing-pattern- Choose Streams vs Pub/Sub Appropriately
9. Clustering & Replication (MEDIUM)
cluster-hash-tags- Use Hash Tags for Multi-Key Operationscluster-read-replicas- Use Read Replicas for Read-Heavy Workloads
10. Security (HIGH)
security-acls- Use ACLs for Fine-Grained Access Controlsecurity-auth- Always Use Authentication in Productionsecurity-network- Secure Network Access
11. Observability (MEDIUM)
observe-commands- Use Observability Commands for Debuggingobserve-metrics- Monitor Key Redis Metrics
How to Use
Read individual rule files for detailed explanations and code examples:
rules/rqe-index-creation.md
rules/vector-rag-pattern.md
Each rule file contains:
- Brief explanation of why it matters
- Correct example(s) with explanation
- Either an "Incorrect" example (for anti-patterns that cause real harm) or "When to use / When NOT needed" guidance (for optional features)
- Additional context and references
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
Related Skills
redis/redis-vector-search
development
VerifiedTrustedCommunity
Redis vector search guidance covering HNSW vs FLAT algorithm choice, vector index configuration (dims, distance metric, datatype), filtered hybrid search combining vector similarity with TAG or NUMERIC filters, and the RAG retrieval pattern with RedisVL. Use when defining a VECTOR field in FT.CREATE, integrating embeddings (OpenAI, Cohere, sentence-transformers), tuning HNSW parameters (M, EF_CONSTRUCTION, EF_RUNTIME), building a retrieval-augmented generation pipeline, or filtering vector results by attribute.
60SKILL.mdUpdated May 28, 2026
redis/redis-semantic-cache
development
VerifiedTrustedCommunity
Redis LangCache guidance for semantic caching of LLM responses on Redis Cloud — calling search/set via the SDK or REST API, tuning the similarity threshold, separating caches per task type, and filtering with custom attributes. Use when caching LLM completions or RAG answers to cut API cost and latency, building a cache-aside layer in front of OpenAI / Anthropic / etc., tuning hit rate vs precision, or splitting one app's LLM workloads into multiple LangCache caches.
60SKILL.mdUpdated May 28, 2026
redis/redis-security
testing
VerifiedTrustedCommunity
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, and disabling dangerous commands. Use when deploying Redis to production, defining ACL users for an application, configuring TLS connections, locking down a Redis instance behind a firewall, or auditing a Redis deployment for security hardening.
60SKILL.mdUpdated May 28, 2026
redis/redis-query-engine
testing
VerifiedTrustedCommunity
Redis Query Engine (RQE) guidance covering FT.CREATE schema design, field type selection (TEXT, TAG, NUMERIC, GEO, GEOSHAPE, VECTOR), DIALECT 2 query syntax, efficient FT.SEARCH and FT.AGGREGATE queries, zero-downtime index updates via aliases, and the SKIPINITIALSCAN option. Use when defining a search index on Hash or JSON documents, picking between TEXT and TAG for filtering, writing FT.SEARCH queries with filters and SORTBY, managing or swapping indexes in production, or troubleshooting slow searches with FT.PROFILE.
60SKILL.mdUpdated May 28, 2026