CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

upstash-redis-kv

Read and write to Upstash Redis-compatible key-value store via REST API. Use when there is a need to save or retrieve key-value data, use Redis features (caching, counters, lists, sets, hashes, sorted sets, etc.) for the current interaction, or when the user explicitly asks to use Upstash or Redis.

67

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

The canonical home for this skill is upstash-redis-kv in intellectronica/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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, copy-paste-ready command reference with a well-specified confirmation policy for destructive operations. Its weaknesses are token efficiency and structure: hundreds of lines restate standard Redis syntax Claude already knows, all of it inline in SKILL.md rather than split into a reference file, and the referenced scripts/upstash-client.ts is missing from the bundle, leaving the only file pointer in the body broken.

Suggestions

Move the full Redis command listings (String/Hash/List/Set/Sorted Set/Key/Server sections) into a references/commands.md file, keeping only the invocation pattern, credential overrides, a few representative examples, and the confirmation policy in SKILL.md — this addresses both the conciseness and progressive-disclosure gaps.

Trim or remove the standard Redis syntax documentation (e.g., '# Push to head', 'Sets store unique, unordered members') and retain only the wrapper's non-standard behavior: its CLI option flags (--ex, --withscores, --limit off,count), output format, and error semantics, which are what Claude cannot infer.

Ship the referenced scripts/upstash-client.ts in the bundle (no scripts/ directory currently exists) or fix the path so the only file reference in the body resolves to a real file, and add a brief post-write verification step (e.g., read the key back after critical writes) to the workflow section.

DimensionReasoningScore

Conciseness

Quotes: "LPUSH <key> <val1> [val2...] # Push to head", "ZRANGE <key> <start> <stop> [--withscores] [--rev]...", "Sets store unique, unordered members". The wrapper-specific material (bun invocation, --url/--token override, output format, confirmation policy) earns its place, but roughly 250 of the ~430 lines re-list standard Redis command syntax and data-type explanations Claude already knows, so it is mostly efficient but could be tightened considerably — not anchor 5's every-token-earns-its-place, and not anchor 2 since the script-specific parts are genuinely non-obvious and the listings are terse rather than padded prose.

3 / 5

Actionability

Quotes: "bun run scripts/upstash-client.ts <command> [args...]", "bun run scripts/upstash-client.ts HSET user:1 name "John" email "john@example.com" age 30", "bun run scripts/upstash-client.ts --url "https://..." --token "AX..." GET mykey". Every command family has copy-paste-ready invocations with worked examples covering common cases (queues, tags, leaderboards, session TTL), fully matching the top anchor.

5 / 5

Workflow Clarity

Quotes: "Before executing any destructive operation (write, modify, or delete), you MUST ask the user for confirmation", the YOLO-mode indicators list, and "If credentials are missing or invalid, the script will exit with an error message". The destructive-operation confirmation gate and error path satisfy the validation requirement, so the destructive-skill cap at 3 does not apply, and the single action (run one command) is unambiguous; it falls short of anchor 5 only for lacking a post-write verification step or broader error-recovery feedback loop beyond credentials.

4 / 5

Progressive Disclosure

Quotes: "## Command Reference" followed by ~300 lines of inline command listings, and the repeated "scripts/upstash-client.ts" reference. Section headers are clear and the layout is scannable, but the bulk command reference is exactly the content the rubric says belongs in a separate file, no references/ files exist, and the one path the body depends on (scripts/upstash-client.ts) is absent from the bundle (no scripts/ directory present) — matching anchor 3's 'content that should be separate is inline' rather than anchor 4's appropriately split structure, though the internal organization is too good for anchor 2's 'minimal structure'.

3 / 5

Total

15

/

20

Passed

Description

91%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 and explicitly states both what the skill does and when to use it, with comprehensive natural trigger terms and both brand names (Upstash, Redis) covered. Its only weaknesses are the broad 'save or retrieve key-value data' trigger clause, which risks overlap with other storage skills, and a somewhat thin set of action verbs (read/write) relative to the feature list.

DimensionReasoningScore

Specificity

Quotes: "Read and write to Upstash Redis-compatible key-value store via REST API" names the domain and two concrete actions, and "use Redis features (caching, counters, lists, sets, hashes, sorted sets, etc.)" enumerates breadth. It lists several specific actions with minor gaps, but the actual verbs are limited to read/write/save/retrieve rather than the fuller action coverage of the top anchor, so it sits at 4, not 5, and well above the 1-2-action coverage of anchor 3.

4 / 5

Completeness

Quotes: "Read and write to Upstash Redis-compatible key-value store via REST API" explicitly answers 'what', and "Use when there is a need to save or retrieve key-value data... or when the user explicitly asks to use Upstash or Redis" explicitly answers 'when' with concrete trigger phrases, matching the top anchor exactly rather than the weaker 'when' of anchor 4.

5 / 5

Trigger Term Quality

Quotes: "save or retrieve key-value data", "use Redis features (caching, counters, lists, sets, hashes, sorted sets, etc.)", "use Upstash or Redis". These are natural phrases a user would say, with synonyms (read/write, save/retrieve) and both brand names (Upstash, Redis) covered; no file extensions apply to this domain, so coverage is comprehensive at 5 rather than the few-terms-missing level of 4.

5 / 5

Distinctiveness Conflict Risk

Quotes: "Upstash Redis-compatible key-value store via REST API" and "use Upstash or Redis" give it a clear niche distinct from other skills, but "Use when there is a need to save or retrieve key-value data for the current interaction" is broad enough to overlap with generic storage/database skills — minor overlap risk, matching anchor 4 rather than the minimal-conflict anchor 5 or the generic overlap of anchor 3.

4 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 24 missing

Warning

Total

15

/

16

Passed

Repository

intellectronica/agent-skills

Path

plugins/upstash-redis-kv/skills/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.