bun-redis

Use when working with Redis in Bun (ioredis, Upstash), caching, pub/sub, session storage, or key-value operations.

Quality

68%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./plugins/bun/skills/bun-redis/SKILL.md

Quality

Content

64%

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

This is a solid reference skill with excellent actionability—every section provides executable, complete TypeScript code examples covering a wide range of Redis use cases. Its main weaknesses are moderate verbosity (covering many basic Redis operations Claude already knows) and lack of validation/error-handling workflows for operations that could fail. The progressive disclosure structure is well-designed in concept but the referenced files don't exist in the bundle.

Suggestions

Trim basic Redis operations (strings, lists, sets) that Claude already knows, keeping only Bun-specific or ioredis-specific patterns and gotchas.

Add error handling and connection retry patterns, especially for the connection setup and pub/sub sections where disconnections are common.

Create the referenced bundle files (references/clustering.md, references/lua-scripts.md) or remove the references if they don't exist.

Move detailed data structure examples into a reference file to keep SKILL.md focused on setup, common patterns, and Bun-specific considerations.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with good use of tables and code blocks, but includes some redundancy (e.g., multiple connection examples that Claude could infer, and the comment 'Same API as ioredis' for Upstash which isn't quite accurate). Some sections like basic string operations are things Claude already knows well. Overall it's reasonably lean but could be tightened.	2 / 3
Actionability	All code examples are fully executable TypeScript with proper imports, concrete values, and copy-paste ready patterns. The caching patterns, rate limiting, session storage, and pub/sub examples are complete and immediately usable.	3 / 3
Workflow Clarity	The caching patterns (cache-aside, write-through) show clear sequences, but there are no validation checkpoints or error handling patterns for connection failures, reconnection strategies, or verifying Redis operations succeeded. The error table helps but doesn't provide recovery workflows.	2 / 3
Progressive Disclosure	The skill references 'references/clustering.md' and 'references/lua-scripts.md' with clear loading criteria, which is good progressive disclosure design. However, no bundle files are provided, so these references don't actually exist. The main content is also quite long (~250 lines) and some sections like detailed data structure operations could be split into reference files.	2 / 3
	Total	9 / 12 Passed

Description

72%

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

The description excels at trigger term coverage and distinctiveness by naming specific technologies (Redis, Bun, ioredis, Upstash) and use cases (caching, pub/sub, session storage). However, it lacks an explicit 'what this skill does' statement — it only provides 'when' guidance without describing the concrete actions or capabilities the skill provides. Adding a capability statement before the 'Use when' clause would significantly improve it.

Suggestions

Add a 'what it does' statement before the 'Use when' clause, e.g., 'Implements Redis connections, caching strategies, pub/sub messaging, and session management in Bun applications using ioredis or Upstash.'

List more specific concrete actions such as 'configure connection pools', 'set up cache invalidation', 'implement pub/sub patterns', or 'manage session TTLs' to improve specificity.

Dimension	Reasoning	Score
Specificity	Names the domain (Redis in Bun) and some actions/use cases (caching, pub/sub, session storage, key-value operations), but doesn't list specific concrete actions like 'set up connection pools', 'configure TTL', or 'implement cache invalidation'. It reads more like a list of topics than concrete actions.	2 / 3
Completeness	The description starts with 'Use when...' which addresses the 'when' aspect well, but the 'what does this do' part is weak — it never explicitly states what the skill does (e.g., 'Guides implementation of Redis patterns' or 'Configures and manages Redis connections'). The what is only implied through the trigger terms.	2 / 3
Trigger Term Quality	Includes strong natural keywords users would say: 'Redis', 'Bun', 'ioredis', 'Upstash', 'caching', 'pub/sub', 'session storage', 'key-value operations'. These cover both library names and conceptual terms users would naturally mention.	3 / 3
Distinctiveness Conflict Risk	The combination of Redis + Bun runtime + specific libraries (ioredis, Upstash) creates a clear niche that is unlikely to conflict with other skills. The specificity of the technology stack makes it highly distinguishable.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: secondsky/claude-skills
Commit: 5e92b71

Reviewed: about 2 months ago

Table of Contents

Discovery Implementation Validation

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.