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.
npx skills add vasilyu1983/AI-Agents-public --skill foundations-distributed-systemsgit clone --depth 1 https://github.com/vasilyu1983/AI-Agents-publicWrote 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.
[](https://agentmods.dev/skills/vasilyu1983/ai-agents-public/foundations-distributed-systems)<a href="https://agentmods.dev/skills/vasilyu1983/ai-agents-public/foundations-distributed-systems"><img src="https://agentmods.dev/badge/skills/vasilyu1983/ai-agents-public/foundations-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.
<a href="https://agentmods.dev/skills/vasilyu1983/ai-agents-public/foundations-distributed-systems"><img src="https://agentmods.dev/badge/skills/vasilyu1983/ai-agents-public/foundations-distributed-systems.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00048 | $0.12570 |
| Opus 5 | $0.00024 | $0.06285 |
| Sonnet 5 | $0.00010 | $0.02514 |
| Haiku 4.5 | $0.00005 | $0.01257 |
Grade A, and why
foundations-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 6d ago.
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.
How it starts
The opening of the file, as written. The whole thing — 438 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Distributed Systems Foundations
11 canonical primitives for distributed systems theory. Each primitive resolves a specific correctness or availability failure. Primitives are domain-agnostic: the same quorum math that governs database replication governs agent-state synchronisation; the same fencing tokens that prevent split-brain in a storage cluster prevent double-writes in a payment processor.
When to Apply
Apply distributed-systems primitives when:
- 2+ nodes participate in a write or shared state (replication, consensus)
- Network partitions are possible and must be tolerated (CAP/PACELC tradeoff)
- Idempotency, exactly-once, or fencing tokens are needed for safety
- Consistency level is being chosen (linearizable / sequential / causal / eventual)
- Multi-region or multi-AZ deployment with failover/quorum requirements
Skip and use simpler alternatives when:
- Single-node system, single writer — none of these primitives apply
- Question is about throughput/latency under load — use foundations-queueing-theory
- Question is about availability/SLO budget — use foundations-reliability-theory
- "We don't have a partition problem" — verify by looking at past incidents; if true, simpler replication patterns suffice
- Eventual-consistency is acceptable AND ordering doesn't matter — use last-writer-wins or CRDTs without consensus
- Strong-consistency demand is a vague preference, not a stated business invariant — challenge it; the cost is high
Contents
- Quick Reference
- Primitive Index
- Formal Supporting Theory
- Misuse Boundaries
- Decision Checklist
- Anti-Patterns
- Expert Diagnosis: Reading Symptoms
- Consistency Level by Product Feature
- The Retry/Timeout/Idempotency Triad
- Most Outages Are Operational, Not Algorithmic
- Testing: Deterministic Simulation and Fault Injection
- Composition Recipes
- Workflow
- ASCII Flow
- Related Skills
- Fact-Checking
What ships with it
19 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- agents/openai.yaml 326 B
- assets/templates/distributed-systems/01-cap-pacelc.md 4.6 KB
- assets/templates/distributed-systems/02-flp-impossibility.md 4.4 KB
- assets/templates/distributed-systems/03-paxos.md 5.5 KB
- assets/templates/distributed-systems/04-raft.md 4.6 KB
- assets/templates/distributed-systems/05-vector-clocks-lamport.md 4.6 KB
- assets/templates/distributed-systems/06-crdts.md 4.7 KB
- assets/templates/distributed-systems/07-idempotency.md 7.3 KB
- assets/templates/distributed-systems/08-leases-fencing.md 5.3 KB
- assets/templates/distributed-systems/09-quorums.md 4.9 KB
- assets/templates/distributed-systems/10-causal-consistency.md 5.2 KB
- assets/templates/distributed-systems/11-broadcast-protocols.md 12 KB
- assets/templates/distributed-systems/README.md 2.8 KB
- data/sources.json 18 KB
- learnings.consolidated.md 607 B
- learnings.md 409 B
- references/formal-theory-map.md 8.2 KB
- references/patterns-scenarios-traps.md 6.3 KB
- references/primitives-overview.md 10 KB
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.
- 6d ago First seen · 438 lines · 48 tokens per session scan A 1c5143c4a5fc
foundations-distributed-systems is a skill published in the GitHub repository vasilyu1983/AI-Agents-public (87 stars, last pushed 8d ago), licensed MIT. It adds 48 tokens to every session and 12,570 once invoked, about $0.0002 per session on Opus 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.
Other skills, from other repositories
stripe-projects
Provision SaaS services + sync creds via Stripe Projects.
architecture-patterns
Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or…
cost-optimization
Optimize cloud costs across AWS, Azure, GCP, and OCI through resource rightsizing, tagging strategies, reserved instances, and spending analysis. Use when reducing cloud expenses, analyzing infrastructure costs, or implementing cost governance policies.
hybrid-cloud-networking
Configure secure, high-performance connectivity between on-premises infrastructure and cloud platforms using VPN and dedicated connections. Use when building hybrid cloud architectures, connecting data centers to cloud, or implementing secure cross-premises networking.
istio-traffic-management
Configure Istio traffic management including routing, load balancing, circuit breakers, and canary deployments. Use when implementing service mesh traffic policies, progressive delivery, or resilience patterns.
terraform-module-library
Build reusable Terraform modules for AWS, Azure, GCP, and OCI infrastructure following infrastructure-as-code best practices. Use when creating infrastructure modules, standardizing cloud provisioning, or implementing reusable IaC components.