discover-distributed-systems

rand's avatarfrom rand

Automatically discover distributed systems skills when working with consensus, CRDTs, replication, partitioning, and distributed algorithms

⭐33stars🔀2forks📁View on GitHub🕐Updated Nov 25, 2025⬇️2downloads

When & Why to Use This Skill

The Distributed Systems Discovery skill is a comprehensive toolkit designed for architects and backend engineers to navigate the complexities of distributed computing. It provides expert-level guidance on consensus algorithms, consistency models, and data synchronization, enabling the design of resilient, scalable, and high-performance distributed architectures.

Use Cases

  • 1. Designing Fault-Tolerant Systems: Implementing consensus protocols like RAFT or Paxos to ensure system reliability and leader election during node failures.
  • 2. Optimizing Data Consistency: Applying CAP theorem trade-offs and Conflict-free Replicated Data Types (CRDTs) to manage state across geographically distributed nodes.
  • 3. Scaling Backend Infrastructure: Developing efficient partitioning and sharding strategies combined with gossip protocols for seamless data distribution and discovery.
  • 4. Advanced Causality Tracking: Utilizing vector clocks and interval tree clocks to resolve data conflicts and maintain event ordering in eventually consistent systems.
namediscover-distributed-systems
descriptionAutomatically discover distributed systems skills when working with consensus, CRDTs, replication, partitioning, and distributed algorithms

Distributed Systems Skills Discovery

Provides automatic access to comprehensive distributed systems skills.

When This Skill Activates

This skill auto-activates when you're working with:

  • Consensus algorithms (RAFT, Paxos)
  • CAP theorem, consistency models
  • CRDTs and eventual consistency
  • Vector clocks, causality
  • Replication and partitioning
  • Distributed locks and leader election
  • Gossip protocols
  • Probabilistic data structures

Available Skills

Quick Reference

The Distributed Systems category contains 17 skills:

  1. cap-theorem - CAP theorem, consistency vs availability trade-offs
  2. consensus-raft - RAFT consensus, leader election, log replication
  3. consensus-paxos - Paxos consensus, Basic/Multi-Paxos
  4. crdt-fundamentals - Conflict-free Replicated Data Types basics
  5. crdt-types - Specific CRDT implementations (LWW, OR-Set, RGA)
  6. dotted-version-vectors - Compact causality, sibling management, optimized vector clocks
  7. interval-tree-clocks - Dynamic causality, fork/join, scalable tracking
  8. vector-clocks - Causality tracking, happens-before
  9. logical-clocks - Lamport clocks, logical time
  10. eventual-consistency - Consistency levels, quorums, BASE
  11. conflict-resolution - LWW, multi-value, semantic resolution
  12. replication-strategies - Primary-backup, multi-primary, chain, quorum
  13. partitioning-sharding - Hash/range/consistent hashing, rebalancing
  14. distributed-locks - Redlock, ZooKeeper locks, fencing tokens
  15. leader-election - Bully, ring, consensus-based election
  16. gossip-protocols - Epidemic protocols, failure detection
  17. probabilistic-data-structures - Bloom filters, HyperLogLog, Count-Min Sketch

Load Full Category Details

For complete descriptions and workflows:

cat ~/.claude/skills/distributed-systems/INDEX.md

This loads the full Distributed Systems category index with:

  • Detailed skill descriptions
  • Usage triggers for each skill
  • Common workflow combinations
  • Cross-references to related skills

Load Specific Skills

Load individual skills as needed:

cat ~/.claude/skills/distributed-systems/cap-theorem.md
cat ~/.claude/skills/distributed-systems/consensus-raft.md
cat ~/.claude/skills/distributed-systems/crdt-fundamentals.md
cat ~/.claude/skills/distributed-systems/replication-strategies.md

Common Workflows

Understanding Consistency Trade-offs

# CAP → Eventual consistency → Conflict resolution
cat ~/.claude/skills/distributed-systems/cap-theorem.md
cat ~/.claude/skills/distributed-systems/eventual-consistency.md
cat ~/.claude/skills/distributed-systems/conflict-resolution.md

Implementing Consensus

# RAFT → Leader election → Replication
cat ~/.claude/skills/distributed-systems/consensus-raft.md
cat ~/.claude/skills/distributed-systems/leader-election.md
cat ~/.claude/skills/distributed-systems/replication-strategies.md

Building Eventually Consistent Systems

# CRDTs → Vector clocks → Conflict resolution
cat ~/.claude/skills/distributed-systems/crdt-fundamentals.md
cat ~/.claude/skills/distributed-systems/vector-clocks.md
cat ~/.claude/skills/distributed-systems/conflict-resolution.md

Advanced Causality Tracking

# Vector clocks → Dotted version vectors → Interval tree clocks
cat ~/.claude/skills/distributed-systems/vector-clocks.md
cat ~/.claude/skills/distributed-systems/dotted-version-vectors.md
cat ~/.claude/skills/distributed-systems/interval-tree-clocks.md

Scaling Data

# Partitioning → Replication → Gossip
cat ~/.claude/skills/distributed-systems/partitioning-sharding.md
cat ~/.claude/skills/distributed-systems/replication-strategies.md
cat ~/.claude/skills/distributed-systems/gossip-protocols.md

Progressive Loading

This gateway skill enables progressive loading:

  • Level 1: Gateway loads automatically (you're here now)
  • Level 2: Load category INDEX.md for full overview
  • Level 3: Load specific skills as needed

Usage Instructions

  1. Auto-activation: This skill loads automatically when Claude Code detects distributed systems work
  2. Browse skills: Run cat ~/.claude/skills/distributed-systems/INDEX.md for full category overview
  3. Load specific skills: Use bash commands above to load individual skills

Next Steps: Run cat ~/.claude/skills/distributed-systems/INDEX.md to see full category details.