distributed-audit

Audit distributed systems for concurrency bugs, replication correctness, and failover safety.

7|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/frogdb/frogdb --skill distributed-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distributed-audit
Source: https://github.com/frogdb/frogdb/tree/main/.claude/skills/distributed-audit
Command: npx skills add https://github.com/frogdb/frogdb --skill distributed-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a thorough correctness audit for distributed systems, identifying concurrency bugs, replication correctness, failover safety, and more.

Core Features & Use Cases

  • Correctness Audit: Identifies concurrency bugs, replication correctness, failover safety, and more.
  • Audit Tiers: Offers Quick Assessment, Focused Audit, and Full Report tiers for different levels of change scope.
  • Risk Domains: Checks for shard-local concurrency, cross-shard atomicity, persistence, replication, cluster topology, failover, client-observable consistency, and pub/sub routing.
  • Fault Scenarios: Analyzes potential fault scenarios including timing faults, crash faults, network faults, resource exhaustion, protocol faults, and concurrency faults.
  • Testing Strategy: Recommends existing test suites and new tests for various risk domains and fault scenarios.
  • Output Templates: Provides Quick Assessment, Focused Audit, and Full Report templates for outputting audit results.
  • Design Review Mode: Offers guidance for auditing design documentation instead of code.
  • Reference File Pointers: Points to relevant documentation for invariants, fault taxonomy, testing patterns, and more.

Quick Start

Trigger an audit by executing: /distributed-audit

Frequently Asked Questions about distributed-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit distributed systems for concurrency bugs and replication correctness?

A distributed systems correctness audit identifies concurrency bugs, replication correctness, and failover safety issues by analyzing risk domains like shard-local concurrency and cluster topology. It evaluates fault scenarios including timing faults, crash faults, and network faults.

How do I test failover safety and cross-shard atomicity in a distributed database?

To test failover safety and cross-shard atomicity, run a correctness audit that evaluates these specific risk domains against potential fault scenarios. The audit then recommends existing test suites and defines new tests to validate cluster topology resilience.

What is the best way to check distributed systems for network faults and protocol faults?

The best way to check for network and protocol faults is to perform a structured correctness audit using the Full Report tier. This evaluates fault scenarios like resource exhaustion and protocol failures, outputting detailed audit templates for your system.

Can I audit distributed systems design documentation instead of source code?

Yes, you can audit design documentation instead of source code using the Design Review Mode. This mode provides guidance for evaluating design docs against invariants, fault taxonomy, and testing patterns without requiring code analysis.

Does a distributed systems correctness audit work for quick assessments of small changes?

Yes, distributed systems correctness audits support quick assessments of small changes through the Quick Assessment tier. This provides a lightweight output template to rapidly evaluate specific risk domains without generating a full report.

What do I need to know before running a distributed systems correctness audit?

Before running a distributed systems correctness audit, you need in-depth knowledge of distributed system concepts and practices. Understanding risk domains like client-observable consistency, pub/sub routing, and persistence is required to interpret audit results.