distributed-systems

distributed-systems is a skill for Claude Code from yonatangross/orchestkit. It costs 48 tokens per session (2,501 once invoked), scanned A, original, MIT.

A collection of patterns for software whose parts run across multiple computers or services. It covers coordination, retries, rate limits, duplicate-request handling, event-driven workflows, and edge computing.

In plain words
What is it for?
Use it when implementing distributed locks, circuit breakers, retry policies, idempotency keys, rate limiters, event-driven systems, or edge workers.
Why use it?
Distributed systems can fail through delays, repeated requests, overloaded services, or machines disagreeing about state. These patterns help applications remain reliable under those conditions.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions Claude Code.

Part of the ork plugin — 111 skills, 38 commands, 36 agents, 32 hooks shipped together

Good fit Use it when implementing distributed locks, circuit breakers, retry policies, idempotency keys, rate limiters, event-driven systems, or edge workers.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/yonatangross/orchestkit/distributed-systems
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add yonatangross/orchestkit --skill distributed-systems
Clone the repo
git clone --depth 1 https://github.com/yonatangross/orchestkit

Made for: Claude Code.

Or install ork, the plugin that ships this one along with the rest of its 111 skills, 38 commands, 36 agents, 32 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for distributed-systems

README.md
[![agentmods](https://agentmods.dev/badge/skills/yonatangross/orchestkit/distributed-systems/github.svg)](https://agentmods.dev/skills/yonatangross/orchestkit/distributed-systems)
Your own site
<a href="https://agentmods.dev/skills/yonatangross/orchestkit/distributed-systems"><img src="https://agentmods.dev/badge/skills/yonatangross/orchestkit/distributed-systems/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for distributed-systems

Your own site · 80×15
<a href="https://agentmods.dev/skills/yonatangross/orchestkit/distributed-systems"><img src="https://agentmods.dev/badge/skills/yonatangross/orchestkit/distributed-systems.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,501 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.02501
Opus 5.5 $0.00019 $0.01000
Sonnet 5.5 $0.00010 $0.00500
Haiku 4.5 $0.00005 $0.00250

Measured 12d ago against content hash 19f144f8754f, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

distributed-systems scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 8 executable files (scripts/bulkhead.py, scripts/circuit-breaker.py, scripts/distributed-lock-template.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/ork/skills/distributed-systems/SKILL.md · 209 lines

How it starts

The opening of the file, as written. The whole thing — 209 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Distributed Systems Patterns

Comprehensive patterns for building reliable distributed systems. Each category has individual rule files in rules/ loaded on-demand.

Quick Reference

Category Rules Impact When to Use
Distributed Locks 1 CRITICAL Fencing tokens, owner validation; Redis/Redlock and Postgres advisory via upstream docs
Resilience 3 CRITICAL Circuit breakers, retry with backoff, bulkhead isolation
Idempotency 1 HIGH Idempotency keys; dedup and database-backed storage via upstream docs
Rate Limiting 2 HIGH Token bucket, sliding window; SlowAPI integration via upstream docs
Edge Computing 2 HIGH Edge workers, V8 isolates, CDN caching, geo-routing
Event-Driven 2 HIGH Event sourcing, CQRS, transactional outbox, sagas

Total: 11 rules across 6 categories. Removed topics point at first-party sources in Upstream coverage; ork-specific scars live in references/ork-delta.md.

Quick Start

# Redis distributed lock with Lua scripts
async with RedisLock(redis_client, "payment:order-123"):
    await process_payment(order_id)

# Circuit breaker for external APIs
@circuit_breaker(failure_threshold=5, recovery_timeout=30)
@retry(max_attempts=3, base_delay=1.0)
async def call_external_api():
    ...

# Idempotent API endpoint
@router.post("/payments")
async def create_payment(
    data: PaymentCreate,
    idempotency_key: str = Header(..., alias="Idempotency-Key"),
):
    return await idempotent_execute(db, idempotency_key, "/payments", process)

# Token bucket rate limiting
limiter = TokenBucketLimiter(redis_client, capacity=100, refill_rate=10)
if await limiter.is_allowed(f"user:{user_id}"):
    await handle_request()

Distributed Locks

Coordinate exclusive access to resources across multiple service instances.

Read the full file on GitHub · 209 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago Changed · -1 lines 19f144f8754f
  2. 20d ago Changed · -5 lines 4111e6061890
  3. 21d ago Changed · -1 lines ad3c95633ee2
  4. 29d ago Changed cb4ab3842b28
  5. 1mo ago Changed bb2ce77d974c
  6. 1mo ago First seen · 216 lines · 48 tokens per session scan A 9ee2b337e480

Subscribe to this mod's changes

distributed-systems is a skill published in the GitHub repository yonatangross/orchestkit (297 stars, last pushed today), licensed MIT. It adds 48 tokens to every session and 2,501 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

microprofile-server

Architecture and coding rules for long-running Java MicroProfile / Jakarta EE server applications — BCE layering, business components (BC), JAX-RS resources, CDI, JSON-P, testing (unit/integration/system), and Maven project structure. Use when creating, generating, scaffolding, writing, or reviewing code, resources…

AdamBien/airails · 87 tokens

tool-design

Design and verify tools that AI agents can actually use — for any framework or language (MCP servers, LangChain/LangGraph, function-calling, raw JSON schema; TypeScript, Python, or otherwise). Use when writing a new tool for an agent, reviewing or fixing an existing tool definition, deciding how to split capabilities…

agentailor/fullstack-langgraph-nextjs-agent · 135 tokens

api-crud-generator

A code generator that creates standard Next.js API routes and an administration page from Prisma models. Prisma is a tool that describes and accesses an application’s database.

xbsheng/atguigu-note · 21 tokens

Agent Workflow Builder

Build multi-agent AI workflows with orchestration, tool use, and state management.

eddiebelaval/squire · 19 tokens

pn-backend-architecture

Scalable system design, database schemas, API contracts, microservices patterns. Use when designing APIs, DBs, or infrastructure before or during backend implementation.

perniemann/pnCore · 37 tokens

pn-node-api

Guides Node/API design, DB access patterns, and env/secrets. Use when designing or implementing Node/API code; covers API design, error handling, config, and DB patterns.

perniemann/pnCore · 41 tokens