CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

redis-patterns

Redis data structure patterns, caching strategies, distributed locks, rate limiting, pub/sub, and connection management for production applications. Use when adding caching, a distributed lock, rate limiting, or pub/sub with Redis, or when key design needs review.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-organized reference with executable code for every pattern and good anti-pattern guidance. Its main weaknesses are the entirely monolithic single-file structure (no progressive disclosure despite covering eight distinct topic areas) and minor redundancy/basic-concept padding in the opening and TTL sections.

Suggestions

Split the deep-dive topics (rate limiting, distributed locks, pub/sub & streams, connection management) into one-level-deep files under references/ (e.g., references/rate-limiting.md, references/locks.md), keeping SKILL.md as a concise overview with the cheat-sheet, quick-reference, and anti-pattern tables plus clearly signaled links.

Trim the 'How It Works' section, which explains Redis fundamentals (data types, TCP/RESP, why pooling matters) that Claude already knows; keep only the non-obvious atomicity constraint that multi-step workflows require Lua or MULTI/EXEC.

Remove the duplicated TTL guidance ('Always set a TTL' appears in both TTL Strategy prose and the Anti-Patterns table) and consider adding explicit validation checkpoints for risky operations, e.g., what to do when lock acquisition fails or when stream consumption errors mid-batch.

DimensionReasoningScore

Conciseness

The body is dense and table-driven with minimal prose padding, but the opening "How It Works" paragraph explains concepts Claude already knows ("Redis is an in-memory data structure store that supports strings, hashes, lists...", "connection pools are essential to avoid per-request handshake overhead"), and the 'always set a TTL' advice is repeated in both the TTL Strategy section and the Anti-Patterns table. These are minor instances of over-explanation that could be trimmed, matching the 4 anchor rather than the lean 5 anchor or the noticeably padded 3 anchor.

4 / 5

Actionability

Virtually every section provides complete, copy-paste-ready code with concrete parameters: cache-aside with `setex(cache_key, 3600, ...)`, an atomic Lua sliding-window script, `SET NX PX` lock acquisition with token-checked Lua release, stream consumer groups with `xreadgroup`/`xack`, and ConnectionPool/Sentinel/RedisCluster configs with real timeouts and limits. This matches the 5 anchor 'fully executable; copy-paste ready code covering the common cases'.

5 / 5

Workflow Clarity

As a pattern-reference skill, it provides clear selection sequencing ('When to Activate' triggers, a Quick Reference pattern table, and scenario-to-pattern Examples), plus some correctness checkpoints like re-checking the cache after acquiring the stampede lock and releasing locks in a `finally` block. However, there are no explicit validation/retry checkpoints for riskier operations (e.g., verifying lock possession before acting, handling failed `xgroup_create` beyond a bare `except: pass`, or validating before bulk deletes), placing it at the 4 anchor with 'most checkpoints present; minor validation gaps' rather than the 5 anchor's explicit validate-fix-retry loops.

4 / 5

Progressive Disclosure

No bundle files exist, so the entire ~400-line reference — spanning eight topic areas (caching, sessions, rate limiting, locks, pub/sub, streams, connection management, eviction) — is inlined in a single SKILL.md. Section headers and tables give it reasonable structure, but this breadth is exactly the content that could be split into one-level-deep reference files (e.g., rate-limiting.md, locks.md) with the body kept as an overview, matching the 3 anchor 'some structure but... content that should be separate is inline'. It is above the 2 anchor because navigation via the Quick Reference table is clear, but below the 4 anchor since no progressive disclosure mechanism exists at all.

3 / 5

Total

16

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly answers both 'what' and 'when' with concrete, natural trigger phrases anchored to a well-defined Redis niche. The only refinements would be expressing capabilities as concrete actions rather than noun phrases and adding a few common synonyms (throttling, session storage, Redis Streams) to widen trigger coverage.

DimensionReasoningScore

Specificity

The description enumerates specific capability areas — "caching strategies, distributed locks, rate limiting, pub/sub, and connection management" — but presents them as noun phrases rather than concrete verb-actions (cf. the 5 anchor's "Extract text and tables... fill forms, merge documents"). Coverage is broad with only minor gaps (e.g., session storage is not named), which fits the 4 anchor 'several specific actions; minor gaps in coverage' better than the 5 anchor's fully action-verb, comprehensive form.

4 / 5

Completeness

Both parts are explicit: the first sentence clearly states what the skill covers, and the second gives a concrete "Use when adding caching, a distributed lock, rate limiting, or pub/sub with Redis, or when key design needs review" trigger clause. This mirrors the 5 anchor's exemplar structure almost exactly, and is clearly above the 4 anchor where the 'when' is only generically phrased.

5 / 5

Trigger Term Quality

Natural trigger terms users would say are well covered: "adding caching", "a distributed lock", "rate limiting", "pub/sub", "Redis", and "key design needs review". It falls short of the 5 anchor's comprehensive synonym coverage — common variations like 'throttling', 'session storage', 'Redis Streams', or 'eviction' are absent, matching the 4 anchor 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

"Redis" anchors a clear niche, and most triggers are Redis-specific, so conflict risk is low. However, generic triggers like "adding caching" could also fire for a general caching or database-persistence skill, so it sits at the 4 anchor 'mostly distinct; minor overlap risk' rather than the 5 anchor's fully distinct trigger set.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/redis-patterns/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.