CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/outbox-pattern-test-author

Authors tests for the transactional outbox pattern: atomic DB-write-plus-event-insert in one transaction, relay/poller publishing with at-least-once delivery and consumer deduplication, insertion-order preservation, idempotent consumers, and relay failure/retry. Use when adding outbox infrastructure, changing the relay or poller, or auditing whether dual-write atomicity and at-least-once delivery guarantees hold under failure.

74

Quality

93%

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

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and well-sequenced, with executable tests per dimension and strong cross-referenced anti-pattern guidance. Its only weakness is conciseness: it re-quotes the source pattern definition verbatim across several steps rather than stating the test contract once.

Suggestions

Replace the repeated verbatim microservices.io quotations in Steps 2, 3, 4, and 5 with a single one-line statement of the contract being tested; cite the reference once rather than re-quoting.

Consolidate the duplicated outbox-INSERT SQL boilerplate (repeated nearly verbatim across Steps 2-6) into one shared helper or fixture to reduce repetition and token cost.

Move the conceptual dual-write preamble in the opening paragraph into the References section, keeping only the test-focused framing in the body.

DimensionReasoningScore

Conciseness

It is mostly efficient, but re-explains the dual-write problem and quotes microservices.io verbatim across multiple steps (e.g. 'the service that sends the message first stores the message in the database...' and 'the message relay might publish a message more than once...'), which is concept framing Claude already knows. It is below 3 due to this unnecessary verbatim repetition, and above 1 because the bulk is task-relevant test code rather than pure padding.

2 / 3

Actionability

Each dimension ships a complete, executable Python test function with concrete fakes (db, broker, relay, consumer) and precise assertions, e.g. test_outbox_insert_commits_with_business_entity and test_relay_retries_pending_rows_after_crash — copy-paste ready and fully specified.

3 / 3

Workflow Clarity

Steps 1-6 give an explicit numbered sequence mapping to the five test dimensions (with a mapping table), an Anti-patterns table cross-referencing each fix to its step, and a Limitations section. These are authoring recipes rather than destructive batch operations, so the validate-fix-retry cap does not apply; the sequence and cross-references are clear.

3 / 3

Progressive Disclosure

No bundle files exist (references/scripts/assets absent), so the skill is a single self-contained file with no nested references, organized into clearly navigable sections (When to use, Steps, Anti-patterns, Limitations, References). External links are one level deep and well signaled. It is below only in the sense that some test code could be split out, but the structure is clean for a standalone skill.

3 / 3

Total

11

/

12

Passed

Description

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.

The description is specific, trigger-rich, and answers both what and when explicitly, while being clearly distinguished from sibling skills. It is concise for the breadth it covers and earns the top level across all four dimensions.

DimensionReasoningScore

Specificity

It enumerates multiple concrete actions — 'atomic DB-write-plus-event-insert in one transaction', 'relay/poller publishing with at-least-once delivery and consumer deduplication', 'insertion-order preservation', 'idempotent consumers', and 'relay failure/retry' — matching the score-3 anchor of listing several specific concrete actions.

3 / 3

Completeness

It explicitly answers what ('Authors tests for the transactional outbox pattern: ...') and when ('Use when adding outbox infrastructure, changing the relay or poller, or auditing whether dual-write atomicity and at-least-once delivery guarantees hold under failure.'), satisfying the score-3 both-what-and-when anchor.

3 / 3

Trigger Term Quality

Natural terms a user would say are well covered: 'transactional outbox pattern', 'outbox infrastructure', 'relay or poller', 'dual-write atomicity', 'at-least-once delivery'. It is not above (already max) and well above score-2 partial coverage.

3 / 3

Distinctiveness Conflict Risk

It carves a clear niche (outbox-pattern test authoring) and even differentiates from the related 'saga-transaction-tests' skill, so it is unlikely to trigger for the wrong skill.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents