CtrlK
BlogDocsLog inGet started
Tessl Logo

iii-queue-processing

Uses `TriggerAction.Enqueue({ queue })` and named queues for reliable background work. Use when a request should hand off slow work and return quickly, a task must retry on failure, jobs need concurrency limits or FIFO ordering, or a workflow needs durable async processing, backoff, and dead-letter handling.

64

Quality

75%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/iii-queue-processing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines its scope around background job queue processing with specific API references and multiple concrete capabilities. It includes a well-structured 'Use when...' clause with four distinct trigger scenarios, and uses appropriately technical but natural terminology that developers would use when seeking this functionality. The description is concise yet comprehensive, covering both the mechanism and the use cases.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and patterns: 'TriggerAction.Enqueue({ queue })', named queues, retry on failure, concurrency limits, FIFO ordering, durable async processing, backoff, and dead-letter handling. These are all concrete, specific capabilities.

3 / 3

Completeness

Clearly answers both 'what' (uses TriggerAction.Enqueue and named queues for reliable background work) and 'when' with an explicit 'Use when...' clause listing four distinct trigger scenarios: handing off slow work, retrying on failure, needing concurrency limits/FIFO, and needing durable async processing.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'background work', 'retry on failure', 'concurrency limits', 'FIFO ordering', 'async processing', 'backoff', 'dead-letter handling', 'queue', 'hand off slow work'. These cover the vocabulary developers naturally use when discussing job queues.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with specific API references ('TriggerAction.Enqueue({ queue })'), named queues, and a clear niche around background job processing. Unlikely to conflict with other skills due to the very specific domain and terminology.

3 / 3

Total

12

/

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 a solid conceptual overview of queue processing with clear API surface coverage, pattern boundaries, and references to implementations in multiple languages. However, it lacks inline executable code examples, explicit validation/verification steps in workflows, and has some redundancy across sections. The reliance on external reference files that aren't bundled weakens the actionability significantly.

Suggestions

Add at least one minimal but complete inline code example showing producer enqueue + consumer handler registration, rather than deferring all code to reference files.

Add an explicit numbered workflow with validation checkpoints for setting up a queue (e.g., 1. Declare in config → 2. Install worker → 3. Verify worker running → 4. Test enqueue → 5. Confirm consumer processes).

Consolidate the 'Common Patterns' section with the 'iii Primitives Used' table to eliminate redundancy — they cover largely the same API surface.

Merge 'When to Use' and 'Boundaries' into 'Pattern Boundaries' to reduce repetitive scoping guidance.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundancy — the 'Common Patterns' section largely restates what's already in the 'iii Primitives Used' table, and sections like 'When to Use' and 'Boundaries' overlap with 'Pattern Boundaries'. Some explanatory text (e.g., 'Use the concepts below when they fit the task') is unnecessary filler.

2 / 3

Actionability

The skill provides API names, CLI commands, and references to full implementations, but the body itself contains no executable code examples — only function signatures and descriptions. The actual working code is deferred entirely to reference files, which were not provided in the bundle, making the skill itself incomplete for copy-paste execution.

2 / 3

Workflow Clarity

The ASCII architecture diagram shows the flow from producer to consumer to DLQ, and the 'Adapting This Pattern' section mentions chaining and idempotency checks. However, there are no explicit validation checkpoints, no error recovery feedback loops, and no step-by-step numbered workflow for setting up or debugging a queue — important given that queue processing involves retries and dead letters.

2 / 3

Progressive Disclosure

The skill references external files (queue-processing.js/py/rs, iii-config.yaml) at one level deep with clear paths, which is good structure. However, no bundle files were provided, so these references are unverifiable. Additionally, the body itself is somewhat long with sections that could be consolidated, and the inline content (primitives table, common patterns, adapting patterns) could benefit from tighter organization or offloading.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
iii-hq/iii
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.