skills.rest
kssumin
kssuminCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/kssumin/claude-playground --skill timeout-tuning
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
jamesogunsanjamesogunsan

python-performance-optimization

Profile Python code to identify hot paths and validate performance improvements.

Community
Intermediate
jrmatherlyjrmatherly

circuit-breaker

Enforce circuit breaker state transitions around fragile external API calls.

Community
Basic
FaysilAlshareefFaysilAlshareef
4

polly-resilience

Compose Polly v8 resilience pipelines for HTTP and non-HTTP .NET operations.

Community
Advanced
danilodsdanilods

sysdesign-newsfeed-fanout

Design hybrid fan-out and merge-on-read for skewed social feeds.

Community
Advanced