idempotency-test-author SKILL.md skillA

idempotency-test-author from testland/qa is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add testland/qa/idempotency-test-author@git:20260728.1bce424

Pins git:20260728.1bce424 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
testland/qa
Path
plugins/qa-async-jobs/skills/idempotency-test-author/SKILL.md
Versions recorded
5
Latest version
git:20260728.1bce424, committed Jul 28, 2026
First version recorded
Jul 6, 2026
Size
7,568 bytes
Repository stars
11
License
MIT

Build-an-X for idempotency tests in any async/job/API context - idempotency-key handling (per Stripe / AWS prescriptive guidance pattern), retry-safe semantics (exactly-once vs at-least-once vs at-most-once), side-effect commutativity verification, fingerprint-based dedup, idempotency-window tuning. Use when authoring tests for any system where the same input could be processed twice (SQS Standard at-least-once, RabbitMQ requeue, retry-on-error logic, webhook redelivery, browser double-click…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# idempotency-test-author

## Overview

Authors idempotency tests for any handler where the same input can be
processed twice. Uses the industry-standard idempotency-key pattern
(client sends a unique key per logical operation; the server records
`key -> response` and returns the cached response on duplicates) plus
commutative-side-effect designs for systems that cannot add keys.
Sources in References.

[aws-idem]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/

## When to use

- Authoring tests for any handler that mutates state on input.
- Reviewing PRs that add a new POST/PATCH endpoint or job processor.
- The system is on at-least-once delivery (SQS Standard, RabbitMQ
  requeue) - idempotency tests are mandatory, not optional.
- Webhook receivers that must handle vendor-side redelivery.

## Step 1 - Classify delivery semantics

| Semantics | Examples | Test requirement |
|---|---|---|
| Exactly-once | SQS FIFO, Kafka with EOS | Idempotency tests are nice-to-have |
| At-least-once | SQS Standard, RabbitMQ requeue, BullMQ retry, webhook redelivery | **Idempotency tests MANDATORY** |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add testland/qa/idempotency-test-author@sha256:79f4d113cbb8a5ea

The line at the top of this page pins the label git:20260728.1bce424, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jymo5ygp2ztcsodt.svg)](https://markdownregistry.com/a/art_jymo5ygp2ztcsodt)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 6, 2026 and Jul 28, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260728.1bce424 latest2026-07-28 1bce424 7,568 BA view · diff
git:20260724.d4db7562026-07-24 d4db756 9,184 BA view · diff
git:20260720.22d020c2026-07-20 22d020c 9,275 BA view · diff
git:20260718.ab299072026-07-18 ab29907 9,287 BA view · diff
git:20260706.4e1409c2026-07-06 4e1409c 9,401 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7568 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

testland/qa · 11 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jymo5ygp2ztcsodt
GET https://markdownregistry.com/api/v1/resolve?ref=testland/qa/idempotency-test-author
GET https://markdownregistry.com/api/v1/blob/79f4d113cbb8a5eac924ba7210889e6fabbfea5db085cd1e9e6ebf9fabfe0f59

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from testland/qa

CLAUDE.md CLAUDE.md file
testland/qa · CLAUDE.md
git:20261011.164aa71 · audit A · 11 stars
a11y-violation-gate SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/a11y-violation-gate/SKILL.md · Builds a CI gate that fails the build on **new** WCAG / a11y violations introduced by a PR while grandfathering…
git:20260813.84b37f4 · audit A · 11 stars
aria-authoring-patterns SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/aria-authoring-patterns/SKILL.md · Reference for the W3C ARIA Authoring Practices Guide (APG) - covers the 31 canonical interactive-widget patterns…
git:20260813.84b37f4 · audit A · 11 stars
axe-a11y SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/axe-a11y/SKILL.md · Automated accessibility scanning across the five engines - axe-core (primary), pa11y, Lighthouse a11y, WAVE, and IBM…
git:20260813.84b37f4 · audit B · 11 stars
screen-reader-test-author SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/screen-reader-test-author/SKILL.md · Builds the full manual-accessibility artifact surface: step-by-step screen-reader test scripts for NVDA (Windows), JAWS…
git:20260813.84b37f4 · audit A · 11 stars
wcag-color-contrast SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/wcag-color-contrast/SKILL.md · Reference for WCAG 2.2 color-contrast conformance - covers SC 1.4.3 Contrast (Minimum, AA), 1.4.6 Contrast (Enhanced…
git:20260813.84b37f4 · audit A · 11 stars
wcag-compliance-reporter SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/wcag-compliance-reporter/SKILL.md · Builds a per-page WCAG 2.2 compliance score report by aggregating output from one or more accessibility scanners…
git:20260813.84b37f4 · audit A · 11 stars
wcag-keyboard-navigation SKILL.md skill
testland/qa · plugins/qa-accessibility/skills/wcag-keyboard-navigation/SKILL.md · Reference catalog for WCAG 2.2 keyboard-navigation conformance - covers SC 2.1.1 (Keyboard), 2.1.2 (No Keyboard Trap)…
git:20260813.84b37f4 · audit A · 11 stars
ai-spec-coverage-mapper SKILL.md skill
testland/qa · plugins/qa-ai-assisted/skills/ai-spec-coverage-mapper/SKILL.md · Build-an-X workflow that uses an LLM to map existing tests to spec sections - given a spec doc + the test suite, the…
git:20260813.83125c6 · audit A · 11 stars
ai-test-generator SKILL.md skill
testland/qa · plugins/qa-ai-assisted/skills/ai-test-generator/SKILL.md · Generates tests from natural-language specs (acceptance criteria, user stories, requirements) using an LLM, with…
git:20260813.83125c6 · audit A · 11 stars
model-based-test-graph-author SKILL.md skill
testland/qa · plugins/qa-ai-assisted/skills/model-based-test-graph-author/SKILL.md · Build-an-X workflow for model-based testing (MBT) per the canonical definition - authors a state-machine model of the…
git:20260813.099f6f5 · audit A · 11 stars
api-chaos-runner SKILL.md skill
testland/qa · plugins/qa-api-testing/skills/api-chaos-runner/SKILL.md · Runs the project's existing API tests under injected network chaos - latency, timeouts, dropped connections, bandwidth…
git:20260726.19ddd36 · audit A · 11 stars

Every file in testland/qa

Browse by kind, by grade A, or by owner.