Content
15%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a hollow skeleton: section headings promise expertise (patterns, anti-patterns, capabilities) but deliver almost no instructional content — no code, no commands, no sequenced workflow, and several empty or incoherent sections. A reader would learn nothing actionable about actually using BullMQ from it.
Suggestions
Replace the persona preamble and the dangling 'Your core philosophy:' line with executable code examples — e.g., a minimal Queue/Worker setup with connection config, and a FlowProducer example — under the existing Patterns headings.
Turn each anti-pattern header into concrete guidance: what 'Giant Job Payloads' / 'No Dead Letter Queue' / 'Infinite Concurrency' look like, how to detect them (e.g., `attempts`, `removeOnFail`, `limiter` options), and the fix.
Rewrite the 'When to Use' section to state actual triggering conditions (e.g., 'When adding background/async processing, scheduled or repeatable jobs, or job dependencies to a Node.js app') instead of the circular reference to a nonexistent overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A substantial fraction of the body is padded or empty rather than instructive: persona fluff ('You are a BullMQ expert who has processed billions of jobs in production... You've debugged stuck jobs at 3am'), a dangling 'Your core philosophy:' heading with no content, three anti-pattern headers with no explanation, and a filler 'When to Use' sentence. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections'); it is not a 1 only because it is short and does not explain concepts Claude already knows. | 2 / 5 |
Actionability | There is no code, no commands, and no configuration anywhere in the body. Sections like 'Production-ready BullMQ queue with proper configuration' and 'Jobs that run at specific times or after delays' only describe rather than instruct, and the anti-patterns are bare headers ('Giant Job Payloads', 'No Dead Letter Queue') with no remediation. This squarely matches anchor 1: 'entirely vague or abstract; no concrete code or commands; only describes rather than instructs.' | 1 / 5 |
Workflow Clarity | No multi-step process is sequenced anywhere — no setup steps, no validation, no error handling. The 'When to Use' section is incoherent, referencing 'the workflow or actions described in the overview' when no overview section exists. This matches anchor 1 ('steps missing or incoherent; no sequence; no validation for risky operations'). | 1 / 5 |
Progressive Disclosure | The body has recognizable sections (Capabilities, Patterns, Anti-Patterns, Related Skills), so it is not a monolithic wall, but the structure is nominal: sections are empty stubs, 'Your core philosophy:' dangles, and the content that would justify the structure (code examples, pattern details, anti-pattern remediation) is neither inline nor in any referenced bundle file (no references/, scripts/, or assets/ exist). This fits anchor 3 — some structure but could be much better organized. It is not 5 because a short no-bundle skill earns that only with well-organized, substantive sections. | 3 / 5 |
Total | 7 / 20 Passed |