When is an arbitrary timeout actually appropriate?

They are only correct when testing actual timing behavior, such as verifying a debounce or throttle interval, and should always be documented with a 'why' comment.

What is condition-based waiting?

It is a testing pattern that waits for a specific state or event to occur instead of using a fixed time delay, making tests faster and more reliable.

How does this skill help with flaky tests?

It identifies 'sleep' or 'timeout' calls that cause race conditions and refactors them into 'waitFor' logic that polls for actual success conditions.

Does it work with React?

Yes, it includes specific patterns and best practices for React Testing Library's built-in asynchronous utilities like findByRole and waitFor.

Why should I avoid arbitrary timeouts?

Fixed delays make tests unnecessarily slow on fast machines and prone to failure on slower machines or under heavy CI load where processes take longer.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: timequity

bytimequity

0•

Security & Testing

Replaces arbitrary test timeouts with intelligent condition polling to eliminate flaky test behavior and race conditions.

The Condition-Based Waiting skill empowers Claude to identify and refactor unreliable tests that rely on arbitrary delays like setTimeout or sleep. By implementing a robust polling pattern, it ensures tests wait for specific conditions—such as state changes, event triggers, or file availability—rather than guessing execution time. This approach significantly improves CI/CD stability, reduces false negatives, and ensures tests run as fast as possible on high-performance machines while remaining resilient under heavy load.

Key Features

01Detects and replaces hard-coded setTimeout and sleep calls in test suites

02Implements intelligent polling logic with configurable timeouts and intervals

03Integrates seamlessly with React Testing Library utilities like findBy and waitFor

040 GitHub stars

05Provides specialized patterns for waiting on events, state changes, and file system updates

06Standardizes error handling with descriptive timeout messages for better debugging

Use Cases

01Eliminating flaky tests in CI/CD environments that fail inconsistently due to timing issues

02Migrating legacy test suites from hard-coded delays to modern asynchronous patterns

03Refactoring complex integration tests that involve multiple asynchronous state transitions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add timequity/plugins condition-based-waiting

For use in Claude.ai and ChatGPT

Download Skill