CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/bullmq-tests

Use whenever a Node.js or TypeScript service uses BullMQ and its queues or workers need tests: producers, worker processors, retries, backoff and repeat jobs, FlowProducer parent-child jobs and QueueEvents, against real Redis (Docker, Testcontainers) or ioredis-mock.

Quality

85%

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

Overview
Quality
Evals
Security
Files

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 well-structured, actionable body whose main weakness is token efficiency: the marketing quote and the README-verbatim 'Basic Queue + Worker pattern' section restate things Claude already knows and duplicate the Worked example. The worked examples themselves are strong, and the single reference file is properly organized with clear navigation.

Suggestions

Delete the marketing blockquote and the 'Basic Queue + Worker pattern' section — Claude already knows basic Queue/Worker usage, and the Worked example covers it completely — and fold the one useful line (no fake mode) into the Overview.

Add the actual Redis provisioning step (a `docker run redis` or Testcontainers snippet, plus the `redisConfig` object for each backend) so the hardest part of setup is copy-paste ready instead of gestured at via './test-config'.

Add a validation note for the integration test, e.g., wrapping the QueueEvents promise in a jest timeout with a failure listener (`events.on('failed', ...)`) so a never-firing 'completed' event surfaces a real error instead of a generic timeout.

DimensionReasoningScore

Conciseness

Mostly efficient, but there is genuine padding: the marketing blockquote ("The fastest, most reliable, Redis-based distributed queue..."), the explanation "The Queue produces; the Worker consumes", and a 'Basic Queue + Worker pattern' section of README-verbatim snippets that duplicates the more complete Worked example. This fits anchor 3 ('includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances', since three separate sections could be cut with no loss.

3 / 5

Actionability

Largely executable guidance: full install commands, a producer test with drain/close lifecycle, a direct processor unit test, and a complete Worker + QueueEvents integration test, plus a fixes column in the anti-patterns table. It falls short of anchor 5 because the trickiest step — actually provisioning Redis — is never shown (no docker/Testcontainers command or connection config, only "a real Redis (Docker / Testcontainers)" and an imported `redisConfig`), and the producer example contains the placeholder `items: [...]`.

4 / 5

Workflow Clarity

The 'How to use' section lays out a clear 5-step sequence (install → connection → producer test → worker test → advanced reference), and checkpoints are mostly present via drain-in-beforeEach, close-in-afterAll, always-await, and the anti-patterns table covering failure modes. Anchor 5 is not reached because there is no explicit run-and-verify loop (e.g., how to confirm the integration test isn't hanging when events never fire), leaving minor validation gaps characteristic of anchor 4.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview with the advanced material (retry/backoff, repeat jobs, FlowProducer, CI wiring) correctly split into references/advanced-patterns-and-ci.md, which exists as a real file, is exactly one level deep, and is clearly signaled twice (How-to-use step 5 and the References section with a content description). Easy navigation, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Description

92%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: it pairs an explicit 'Use whenever' trigger clause with a comprehensive, concrete enumeration of what gets tested (producers, processors, retries/backoff, repeat jobs, flows, events) and against which backends. The only room for improvement is broader natural-language synonyms beyond the BullMQ-specific vocabulary.

DimensionReasoningScore

Specificity

Enumerates concrete, specific capabilities — "producers, worker processors, retries, backoff and repeat jobs, FlowProducer parent-child jobs and QueueEvents, against real Redis (Docker, Testcontainers) or ioredis-mock" — comprehensively covering the BullMQ testing surface rather than gesturing vaguely. It exceeds anchor 4 ('several specific actions; minor gaps') because the feature list is exhaustive for this domain.

5 / 5

Completeness

Explicitly answers both questions: the "what" is the enumerated test types and backends, and the "when" is the leading clause "Use whenever a Node.js or TypeScript service uses BullMQ and its queues or workers need tests" with concrete trigger conditions. Matches the anchor-5 example pattern (capabilities + 'Use when...' with specific triggers); anchor 4's caveat ('when' could be more explicit) does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "BullMQ", "queues or workers", "Node.js or TypeScript", "retries", "backoff", "tests" — terms a user would actually say. Not anchor 5 because common variations like "job queue", "background jobs", or "testing" phrasing synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

Clear niche gated on the named library BullMQ in Node.js/TypeScript; unrelated testing skills (Sidekiq, Celery, generic Redis) would not fire on these triggers. Minimal conflict risk, matching anchor 5; it does not fall to anchor 4 since no closely related skill shares these triggers.

5 / 5

Total

19

/

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.

Reviewed

On this page