idempotency

Community

Ensure API calls are idempotent and safe.

Authorjrmatherly
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill prevents duplicate side effects by ensuring idempotent API operations across retries, saving time and reducing errors in critical workflows.

Core Features & Use Cases

  • Idempotency Store: Centralized storage for request status, keyed by method, path, and idempotency key.
  • Locking & Replay Prevention: Short-lived processing lock and cached responses to safely replay requests.
  • Cross-Platform Middleware: Implementations for Express (TypeScript) and FastAPI (Python) with Redis as backend.
  • Use Case: Protect payments, order creation, webhooks, and any endpoint susceptible to retry storms.

Quick Start

Install a Redis instance, install the skill’s dependencies, wire in the idempotency middleware, and test by sending repeated requests with the same Idempotency-Key.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: idempotency
Download link: https://github.com/jrmatherly/metorial-workspace/archive/main.zip#idempotency

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.