🔁
AI EngineeringTypeScript

Idempotent Side Effects

by AIScientists-Dev

Idempotent Side Effects is an AI Engineering skill for Claude Code, published by AIScientists-Dev in Flowtrace.

490 stars33 forkson AIScientists-Dev/FlowtraceAdded 2026/08/26+2% in starsRepository updated 2026/06/09
agent-skillsagentic-aiaiai-agentai-agentsanthropicclaudeclaude-codeclaude-skillsclicodexcursordeveloper-toolsllm
Install in seconds
Install Idempotent Side Effects
Copy Idempotent Side Effects into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/AIScientists-Dev/Flowtrace/tree/main/scripts/examples/swe-bugfix/fixtures/writing_skills ~/.claude/skills/writing_skills

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/AIScientists-Dev/Flowtrace.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
scripts/examples/swe-bugfix/fixtures/writing_skills/new_skill.md in AIScientists-Dev/Flowtrace
Installs to
~/.claude/skills/writing_skills
Collection
One of 3 skills cataloged from this repository
Category
AI Engineering2451 skills

What Idempotent Side Effects does

Idempotent Side Effects helps prevent duplicate external actions when retries or concurrent requests hit the same idempotency key. Use it to make check-then-act flows atomic and return the original result to later callers.

Idempotent Side Effects is cataloged under AI Engineering on DirSkills. Idempotent Side Effects comes from a repository tagged agent-skills, agentic-ai, ai, ai-agent and ai-agents.

Documentation

README

⚠️ Illustrative — distilled in a fictional demo run; not about any real project.

Idempotent Side Effects

Overview

A side effect guarded by "look up the key, and if it's missing, do the thing, then record the key" is a check-then-act (TOCTOU) race. Two concurrent requests with the same key both pass the lookup before either records, so the effect fires twice.

Core principle: Check and claim must be ONE atomic operation at the shared store. Looking up a key is not reserving it.

When to Use

This is the opening of the README. Read the full README on GitHub.

Commands Idempotent Side Effects provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /dict

Frequently asked about Idempotent Side Effects

  • What else does AIScientists-Dev publish alongside Idempotent Side Effects?

    Idempotent Side Effects is one of 3 skills that DirSkills catalogs from AIScientists-Dev/Flowtrace, the repository it ships in. Its siblings there include Make Trace and Mira Tan Perspective. Each one is a separate skill with its own page in this directory, installs the same way Idempotent Side Effects does, and is maintained by AIScientists-Dev in that same repository. The rest of the collection is listed on the AIScientists-Dev/Flowtrace page.

  • How does Idempotent Side Effects compare to other AI Engineering skills?

    Idempotent Side Effects ranks #2190 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Idempotent Side Effects against them. Open each page to compare what they document and how they install.