CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

run-macro-benchmarks

Run a RediSearch end-to-end macro benchmark from tests/benchmarks/*.yml via redisbench-admin. Use this when you want to measure whole-module performance (throughput/latency) against a real redis-server, not micro Rust or C++ benchmarks.

Quality

91%

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

96%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.

An exemplary operational skill: every step is executable, validations and failure modes are explicit and project-specific, and error recovery is carefully specified (refuse to guess, ask before touching a busy server, never re-run an expensive benchmark). The only structural improvement is clearer signaling/formatting of the external doc pointers.

DimensionReasoningScore

Conciseness

Lean and command-driven throughout; the only prose conveys project-specific failure modes Claude cannot know (stale-server silent misload failing a keyspace check with '0 != <expected>', debug/coverage builds silently mislabelled as release numbers, 'unknown command JSON.SET' without RedisJSON). Nothing explains concepts Claude already knows and nothing is padding.

5 / 5

Actionability

Fully executable guidance: ready-to-run checks ('find "$(pwd)/bin" -name redisearch.so -path '*-release/*'', 'ss -ltn | grep -q ':6379 '', 'uv pip install -r ./tests/benchmarks/requirements.txt') and a complete copy-paste run script including the resolve_release_module guard, mktemp log capture, and the full redisbench-admin run-local invocation. The only placeholder is the intentional '<benchmark>' argument.

5 / 5

Workflow Clarity

Clear numbered sequence with explicit validation checkpoints and error-recovery loops: module resolution must yield exactly one release binary or it aborts and asks the user, the port-6379 check reports and asks rather than killing, the run-once rule directs grep/rg on the saved $LOG instead of re-running, and concurrency with builds is explicitly forbidden. Prerequisites are verified before the run and results are summarized at the end.

5 / 5

Progressive Disclosure

Well-organized sections (Arguments, Prerequisites, Instructions) with all content appropriately inline for a ~100-line single-file skill and no bundle files to reference. It falls short of a 5 because pointers to developer.md and AGENTS.md are bare mentions rather than clearly signaled references, and the inline run script could arguably live in a scripts/ file.

4 / 5

Total

19

/

20

Passed

Description

82%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 with an explicit what-and-when structure, concrete tooling and file locations, and excellent distinctiveness via the explicit contrast with micro-benchmarks. Its main weaknesses are the second-person voice in the 'when' clause and slightly limited action/keyword coverage.

Suggestions

Rewrite the 'when' clause in third person to match the good examples, e.g. 'Use when the user wants to measure whole-module performance (throughput/latency) against a real redis-server...' — this also recovers the specificity penalty.

Broaden trigger vocabulary with natural synonyms such as 'ops/sec', 'performance regression', or 'benchmark run' that users would say when asking for this skill.

Optionally mention the outcome deliverable (a summarized throughput/latency report) so users searching for 'benchmark results' trigger this skill.

DimensionReasoningScore

Specificity

The description names a concrete action with specifics ('Run a RediSearch end-to-end macro benchmark from tests/benchmarks/*.yml via redisbench-admin', 'measure whole-module performance (throughput/latency)'), which would rate 4, but the second-person phrasing 'Use this when you want to measure' violates the third-person voice rule and incurs the -1 specificity penalty.

3 / 5

Completeness

It explicitly answers both 'what' ('Run a RediSearch end-to-end macro benchmark from tests/benchmarks/*.yml via redisbench-admin') and 'when' ('Use this when you want to measure whole-module performance... against a real redis-server'), with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('benchmark', 'macro benchmark', 'end-to-end', 'throughput/latency', 'redis-server', plus the negative trigger 'not micro Rust or C++ benchmarks'), but misses common variations like 'ops/sec', 'performance regression', or 'benchmark the module' that a user might naturally say.

4 / 5

Distinctiveness Conflict Risk

Clear niche (RediSearch macro/E2E benchmarks via redisbench-admin) with an explicit boundary against overlapping skills ('not micro Rust or C++ benchmarks'), minimizing the risk of triggering for the wrong skill.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

RediSearch/RediSearch

Path

.skills/run-macro-benchmarks/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.