CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloudflare-queues

This skill should be used when the user asks to "set up Cloudflare Queues", "create a message queue", "implement queue consumer", "process background jobs", "configure queue retry logic", "publish messages to queue", "implement dead letter queue", or encountering "queue timeout", "message retry", "throughput exceeded", "queue backlog" errors.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/cloudflare-queues/skills/cloudflare-queues/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, highly actionable overview with real one-level-deep reference files and clear load triggers. Its main defects are cross-section redundancy (rules, errors, and limits repeat the same facts), missing post-deploy verification in the workflow, and phantom bundle paths — the templates, agents, and commands the body repeatedly points to do not exist.

Suggestions

Add the missing templates/ directory (queues-producer.ts, queues-consumer-explicit-ack.ts, queues-retry-with-delay.ts, queues-dlq-pattern.ts, wrangler-queues-config.jsonc) or remove every 'Load templates/...' and agents/commands mention — use cases 2-4 currently point to files that cannot be loaded.

Collapse the redundancy: merge 'Critical Rules' with 'Top 3 Critical Errors' and 'Limits & Quotas' into one section, and drop the per-file blurbs in 'Using Bundled Resources' since 'When to Load References' already covers them — this would recover roughly a third of the body's tokens.

Add a validation step to the Quick Start workflow (e.g. after deploy, run `bunx wrangler queues info my-queue` and send a test message to confirm the consumer processes it) and a verify-empty check before any queue deletion.

DimensionReasoningScore

Conciseness

The body is dense with executable code rather than concept explanation (good), but carries noticeable redundancy: the 10 Always/10 Never rules restate the Top 3 Errors verbatim (explicit ack, sendBatch, 128 KB, 5000 msg/s appear in all three sections), the limits table repeats numbers already given in Critical Rules, and 'Using Bundled Resources' re-describes the same 11 references already covered by 'When to Load References'. This matches 'mostly efficient but includes some unnecessary... could be tightened' better than the 'minor instances' of anchor 4, though the status line 'Last Verified: 2025-12-27' is an additional time-sensitive token outside a deprecation section.

3 / 5

Actionability

Most guidance is copy-paste ready: complete wrangler.jsonc producer/consumer configs, working TypeScript for both handlers, wrong-vs-correct error solutions, and the size-check-before-send pattern with real code. It stops short of anchor 5 because use cases 2-4 (non-idempotent writes, retry with backoff, DLQ pattern) delegate entirely to `templates/*.ts` files that do not exist in the bundle, leaving those paths with no executable guidance at all.

4 / 5

Workflow Clarity

Quick Start gives a clear sequenced path (create queue → producer → consumer → deploy) and the error solutions include feedback loops for batch operations (per-message try/catch with independent retry, size validation before send), which satisfies the batch-operation feedback-loop expectation. Not anchor 5: there is no verification checkpoint after deploy (e.g. confirming messages flow via `wrangler queues info` before declaring success) and the destructive 'delete queue' path is warned about but has no verify-empty-first step.

4 / 5

Progressive Disclosure

The 11 references/ files all exist on disk, are exactly one level deep, and are unusually well signaled via a dedicated 'When to Load References' section with per-file conditions — close to anchor 5. It drops to anchor 4 because the body also directs the reader to 6 templates, 2 agents, and 3 commands that are absent from the bundle (no templates/ directory exists), and the reference descriptions are duplicated across two sections instead of a single navigation point.

4 / 5

Total

15

/

20

Passed

Description

66%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 trigger-focused description with strong, natural 'when' coverage in both request and error forms, written in third person. Its main weakness is the absence of any explicit 'what' statement — the skill's capabilities are only implied through quoted user requests — and a few generic queue terms that create mild overlap risk with other message-broker skills.

Suggestions

Add an explicit capability statement before the trigger clause, e.g. 'Sets up Cloudflare Queues producers and consumers, including DLQ, retries, batch processing, and troubleshooting. Use when...' — this directly fixes the missing 'what' in completeness.

Include the synonym forms already present in frontmatter keywords ("DLQ", "wrangler queues", "async processing") in the description text to lift trigger-term coverage toward comprehensive.

Anchor the generic triggers ("create a message queue", "process background jobs") to the Cloudflare context to reduce conflict risk with non-Cloudflare queueing skills.

DimensionReasoningScore

Specificity

The trigger phrases name several concrete actions ("set up Cloudflare Queues", "implement queue consumer", "configure queue retry logic", "implement dead letter queue", "publish messages to queue"), matching the 'several specific actions with minor gaps' anchor rather than anchor 3, which expects only 1-2 actions. It falls short of anchor 5 because it never states the skill's actual capabilities (producer/consumer configuration, DLQ, error troubleshooting) as such — the actions appear only as quoted user requests.

4 / 5

Completeness

The 'when' is explicit and concrete ("This skill should be used when the user asks to... or encountering... errors"), but there is no 'what' statement — the description never says what the skill does, sitting between anchor 2 ('when' present without 'what') and anchor 3 (clear 'what' present). The action phrases only weakly imply capabilities, so it cannot reach anchor 4, which requires both a 'what' and a 'when'.

3 / 5

Trigger Term Quality

Trigger terms are natural user phrasings and include both request forms ("create a message queue", "process background jobs") and error-message forms ("throughput exceeded", "queue backlog", "message retry"), which is good coverage. Not anchor 5 because common synonyms are missing from the description itself — "DLQ", "wrangler", "async processing", "batch" appear only in the frontmatter keywords, not the description text.

4 / 5

Distinctiveness Conflict Risk

Triggers like "Cloudflare Queues", "throughput exceeded" (a Cloudflare Queues-specific error) and DLQ patterns are clearly niche, matching 'mostly distinct; minor overlap risk'. Not anchor 5 because several triggers are provider-agnostic — "create a message queue", "process background jobs", "message retry" would equally fire for AWS SQS, RabbitMQ, or BullMQ skills.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (519 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/cloudflare-queues/skills/cloudflare-queues/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.