timeout-tuning

Derive API timeouts from measured p99 values and validate against circuit-breaker thresholds.

1|Updated Feb 21, 2026

Search Tags:#reliability #latency #measurement #timeout #circuit-breaker #p99 #sendmock

Ready to run

npx skills add https://github.com/kssumin/claude-playground --skill timeout-tuning

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: timeout-tuning
Source: https://github.com/kssumin/claude-playground/tree/main/.claude/skills/timeout-tuning
Command: npx skills add https://github.com/kssumin/claude-playground --skill timeout-tuning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Derive reliable API timeouts from measured p99 values and validate them against circuit-breaker thresholds. This methodology helps teams ensure stable external-service communication by grounding timeout decisions in actual latency distributions rather than arbitrary numbers.

Core Features & Use Cases

Real-measurement based timeout derivation: connect_timeout = p99_connect × multiplier and read_timeout = p99_read × multiplier.
CB threshold validation and bimodal gap checks for robust reliability and fail-fast behavior.
Guidance for design changes: CB design choices, and usage of sendmock distribution measurements to validate performance under varied latency scenarios.

Quick Start

Run the measurement workflow to estimate p99 times and configure timeouts accordingly.

Frequently Asked Questions about timeout-tuning

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

FAQPage Schema

How do I calculate API timeouts from real p99 latency measurements?▼

To calculate API timeouts from p99 latency, measure real p99 values for connection and read times, then multiply by a configured multiplier to derive connect_timeout and read_timeout values.

What is a bimodal gap check in circuit-breaker threshold validation?▼

A bimodal gap check validates circuit-breaker thresholds by verifying a valid latency gap exists between normal and failure distributions, ensuring robust fail-fast behavior and reliable external-service communication.

How do I validate circuit-breaker behavior against measured latency distributions?▼

Validate circuit-breaker behavior by comparing measured p99 latency distributions against configured CB thresholds, checking bimodal gap validity to ensure fail-fast triggers activate appropriately under real load.

Can I use sendmock distribution measurements for timeout tuning in test and production environments?▼

Yes, sendmock distribution measurements validate timeout tuning performance across both test and production environments by simulating varied latency scenarios to confirm circuit-breaker design choices.

Why should I tune external service timeouts using p99 measurements instead of arbitrary numbers?▼

Tuning external service timeouts using p99 measurements grounds decisions in actual latency distributions rather than arbitrary numbers, ensuring stable communication and preventing premature circuit-breaker trips.