Inspects and redrives jobs that exhausted all retries. Use when handling failed queue jobs, debugging processing errors, or implementing retry strategies.
70
62%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/iii-dead-letter-queues/SKILL.mdQuality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is well-structured with a clear 'what' and 'when' clause, and targets a distinct niche around failed queue job handling. Its main weakness is moderate specificity—it could enumerate more concrete actions—and the trigger terms could include more natural variations and technology-specific keywords that users commonly use.
Suggestions
Add more specific concrete actions such as 'view error details, filter by failure reason, bulk redrive, configure retry limits'.
Include additional natural trigger terms users might say, such as 'dead letter queue', 'DLQ', 'SQS', 'background job failures', 'worker errors'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (queue jobs) and some actions ('inspects and redrives jobs that exhausted all retries'), but doesn't list multiple concrete actions comprehensively—e.g., it could mention viewing error logs, filtering by failure type, or configuring retry policies. | 2 / 3 |
Completeness | Clearly answers both 'what' (inspects and redrives jobs that exhausted all retries) and 'when' (Use when handling failed queue jobs, debugging processing errors, or implementing retry strategies) with an explicit 'Use when...' clause. | 3 / 3 |
Trigger Term Quality | Includes relevant terms like 'failed queue jobs', 'retry', 'processing errors', but misses common variations users might say such as 'dead letter queue', 'DLQ', 'SQS', 'background jobs', 'worker failures', or specific queue technology names. | 2 / 3 |
Distinctiveness Conflict Risk | The description targets a clear niche—failed queue job inspection and redrive—which is unlikely to conflict with other skills. The combination of 'redrives', 'exhausted retries', and 'queue jobs' creates a distinct trigger profile. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides useful domain-specific information about iii engine DLQ operations with concrete SDK/CLI commands and clear references to external files. However, it lacks an explicit step-by-step workflow with validation checkpoints for what is essentially a batch/destructive operation (redriving), and includes some boilerplate sections that dilute the signal. The actionability would benefit from a complete inline code example rather than deferring entirely to reference files.
Suggestions
Add an explicit numbered workflow with validation steps: check DLQ status → investigate errors → deploy fix → redrive → verify DLQ depth is zero, with the specific commands at each step.
Include at least one complete inline code example (e.g., a JS snippet that checks status, redrives, and verifies) rather than relying solely on bullet-point snippets and external reference files.
Remove or consolidate the boilerplate 'When to Use', 'Boundaries', and 'Pattern Boundaries' sections into a single brief 'Scope' note to improve conciseness.
Fix the broken sentence in the Reference Implementation section where 'redriving failed jobs via SDK and CLI' is orphaned after the Python/Rust references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some unnecessary sections like 'When to Use' and 'Boundaries' that are boilerplate/meta rather than instructive. The 'Architecture' section narrates what Claude already understands about DLQ patterns. Some redundancy between the primitives table and 'Common Patterns' section. | 2 / 3 |
Actionability | Provides concrete SDK calls and CLI commands with specific examples (e.g., redrive payload, expected return shape), but lacks inline executable code blocks showing a complete workflow. The actual implementation is deferred to reference files, and the common patterns section is a bullet list of snippets rather than a cohesive, copy-paste-ready example. | 2 / 3 |
Workflow Clarity | The Architecture section describes the sequence narratively (fail → retry → DLQ → inspect → fix → redrive) and the best practice bullet mentions investigating before redriving, but there's no explicit numbered workflow with validation checkpoints. Missing a clear 'check DLQ status → investigate → fix → redrive → verify DLQ depth decreased' feedback loop despite this being a destructive/batch operation (redriving all failed jobs). | 2 / 3 |
Progressive Disclosure | References to external files (dead-letter-queues.js/py/rs, iii-config.yaml) are present and one-level deep, which is good. However, no bundle files were provided to verify these references exist, the reference file sentence is awkwardly split across lines, and the main content includes material that could be more tightly organized (e.g., Pattern Boundaries, When to Use, and Boundaries sections are boilerplate that adds noise). | 2 / 3 |
Total | 8 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d51a06d
Table of Contents
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.