Backend Idempotency
Use when the user asks about idempotency keys, a payment endpoint that charges twice when the client retries, safe retries, duplicate requests or deduplication. Produces an idempotency-key store and middleware. Not for message consumer dedupe in brokers (use backend-message-queue) or locks (use backend-distributed-locking).
Install
npx skills add j4flmao/agent-skills --skill backend-idempotencygit clone --depth 1 https://github.com/j4flmao/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/backend/universal/idempotency ~/.claude/skills/backend-idempotencyPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Backend Idempotency
## Purpose
Guarantee exactly-once execution for mutating operations using idempotency keys, enabling safe retries without duplicate side effects. Idempotency is the foundation of reliable distributed systems — without it, network retries cause duplicate orders, double charges, and inconsistent state.
## Agent Protocol
### Trigger
Exact user phrases: "idempotency", "idempotent", "idempotency key", "exactly-once", "retry safety", "deduplication", "duplicate detection", "idempotent endpoint", "safe retry".
### Input Context
- Which endpoints need idempotency guarantees.
- Existing data store (Redis, PostgreSQL, DynamoDB).
- Current retry configuration.
### Output Artifact
Idempotency key handling design. No file unless requested.
### Response Format
```
Endpoint: {method} {path}
Key Source: {client-provided|server-generated}
Storage: {store type}
TTL: {duration}
```
### Completion Criteria
- [ ] Idempotency key storage implemented with TTL.
- [ ] Key uniqueness enforced at database level.
- [ ] Response caching: same key returns same response.
- [ ] Expired keys handled gracefully.
- [ ] Concurrent requests with same key resolved (first wins or lock).
### Max Response Length
4 lines per endpoint. 15 lines for full solution.
## Architecture Decision Tree
### Which Idempotency Strategy?Details
- Skill name
backend-idempotency- Repository
- j4flmao/agent-skills
- Path
skills/backend/universal/idempotency/SKILL.md- License
- MIT
- Repo updated
- 17 November 2026
FAQ
What does the Backend Idempotency skill do?
Use when the user asks about idempotency keys, a payment endpoint that charges twice when the client retries, safe retries, duplicate requests or deduplication. Produces an idempotency-key store and middleware. Not for message consumer dedupe in brokers (use backend-message-queue) or locks (use backend-distributed-locking).
How do I install the Backend Idempotency skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add j4flmao/agent-skills --skill backend-idempotency. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Backend Idempotency popular?
It lives in j4flmao/agent-skills, which has 45 GitHub stars and 6 forks.
Related skills
Agent Observability
45j4flmao/agent-skills
Use when the user asks about agent observability, tracing agent reasoning, debugging an agent loop, OpenTelemetry GenAI spans for LLM calls, LLM cost tracking per agent, agent audit logs or hallucination/eval monitoring in production. Produces instrumentation config, trace schema, dashboards, alerts and cost attribution. Not for generic service tracing without LLMs (use devops-opentelemetry).
AI Agent Architectures
45j4flmao/agent-skills
Use when the user asks to build an AI agent, design an agent that calls tools and keeps memory, write an agent system prompt or pick an agent framework (Claude Agent SDK, OpenAI Agents SDK, LangGraph). Produces an architecture brief covering loop, tools, memory, guardrails and evals, routing depth to child skills. Not for workflow patterns (use ai-agentic-workflows).
AI Agent Core Loop
45j4flmao/agent-skills
Use when the user asks about the agent loop, ReAct vs plan-and-solve, re-planning, Reflexion, an agent stuck in a loop, max iterations or termination conditions. Produces a loop spec or patch with state, success predicate, caps and no-progress detection. Not for overall agent design (use ai-agent-architectures) or tool schemas (use tool-calling-principles).
Backend Internationalization
45j4flmao/agent-skills
Use when the user asks about backend i18n, translating API messages, locale negotiation (Accept-Language), ICU MessageFormat, pluralization, BCP 47 tags or locale-aware dates and currency. Produces a server-side localization setup. Not for UI string handling (use frontend-internationalization).
Backend Grpc Patterns
45j4flmao/agent-skills
Use when the user asks about gRPC, protobuf messages and a gRPC service, unary or streaming RPCs, deadlines, interceptors, gRPC status codes or proto evolution with reserved fields. Produces .proto definitions and server/client code. Not for REST design (use backend-api-design).
Backend Message Queue
45j4flmao/agent-skills
Use when the user asks about Kafka topics and partitions, RabbitMQ exchanges, SQS, consumer groups, consumer lag, dead letter queues, retention or message size limits. Produces broker topology and producer/consumer configuration. Not for event design between services (use backend-event-driven) or stream processing (use data-streaming).
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.