When should I still use an arbitrary timeout?

Hard timeouts are only appropriate when you are specifically testing time-dependent logic, such as verifying a debounce interval or a throttle. In those cases, the timeout should always be documented with a comment explaining the specific timing requirement.

Why is condition polling better than using setTimeout or sleep?

Arbitrary timeouts are just guesses that often fail on slower CI machines or under heavy load. Condition polling waits for the actual state change to occur, making tests both faster (they continue immediately upon success) and more reliable.

How does this improve CI/CD performance?

By eliminating 'wait padding' (e.g., waiting 500ms for a 10ms task), your test suite runs as fast as the code allows. It also reduces false negatives in CI, preventing unnecessary build re-runs.

Can this skill be used with any testing framework?

Yes, the patterns provided by this skill are framework-agnostic and can be implemented in Jest, Vitest, Mocha, Playwright, or any other JavaScript/TypeScript testing environment.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: dsifry

bydsifry

•

セキュリティとテスト

Eliminates flaky tests and race conditions by replacing arbitrary timeouts with smart, deterministic condition polling.

Condition-Based Waiting is a specialized Claude Code skill designed to stabilize test suites by moving away from brittle, time-based delays. It provides a deterministic approach to testing asynchronous operations by polling for specific state changes, events, or file system updates rather than guessing execution times. This ensures tests remain robust across different environments—from fast local machines to high-load CI/CD pipelines—significantly improving pass rates and reducing unnecessary idle time during test execution.

主な機能

01Implements generic polling patterns with customizable timeouts and intervals

02Replaces brittle setTimeout and sleep calls with smart polling logic

0329 GitHub stars

04Guards against common pitfalls like CPU-heavy polling and stale data caching

05Includes clear error reporting for timeout failures to speed up debugging

06Provides specialized helpers for event detection, state changes, and file system checks

ユースケース

01Ensuring file system operations or event emissions are complete before running assertions

02Waiting for complex asynchronous state transitions in frontend or backend code

03Fixing flaky integration tests that fail intermittently in CI environments

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dsifry/goodtogo condition-based-waiting

For use in Claude.ai and ChatGPT

Download Skill