Does this skill work with any testing framework?

Yes, while the patterns are shown in TypeScript, the core principles of polling-based waiting are applicable to any language or framework including Python, Java, and Go.

Why are arbitrary timeouts bad for testing?

Arbitrary timeouts (like sleep/setTimeout) are guesses. They lead to race conditions where tests pass on fast local machines but fail on slower CI servers or under load.

How does this skill improve test speed?

Instead of waiting for a fixed duration (e.g., 500ms), condition-based waiting proceeds the millisecond the condition is met, often reducing test execution time by 40% or more.

How does the skill handle conditions that never resolve?

All polling patterns implemented by this skill include mandatory timeouts that throw descriptive errors, preventing infinite loops and providing clear debugging info.

When should I still use a hardcoded timeout?

Fixed timeouts are only appropriate when testing actual timing-dependent behavior, such as verifying a debounce interval or a throttle period, and should always be documented.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: Kingly-Agency

byKingly-Agency

0•

Seguridad y Pruebas

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

The Condition-Based Waiting skill empowers Claude to identify and refactor brittle test suites that rely on hardcoded delays or sleep statements. By implementing intelligent polling patterns, it ensures that tests proceed only when a specific state, event, or file change is confirmed. This approach eliminates non-deterministic failures (flakiness) in CI/CD pipelines, optimizes test execution speed by removing unnecessary idle time, and provides clear, descriptive error messages when timeouts do occur.

Características Principales

01Identifies hardcoded sleep and setTimeout calls in test code

02Automates documentation for justified timing-based logic

03Implements reusable polling helpers with configurable intervals and timeouts

04Prevents CPU waste with optimized polling intervals

050 GitHub stars

06Supports waiting for events, state machine changes, and file system updates

Casos de Uso

01Refactoring flaky CI/CD pipelines that fail inconsistently across different environments

02Hardening asynchronous logic tests where execution order is non-deterministic

03Accelerating test suite performance by replacing fixed delays with immediate state detection

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kingly-agency/kingly-claude-adapter condition-based-waiting

For use in Claude.ai and ChatGPT

Características Principales

01Identifies hardcoded sleep and setTimeout calls in test code

02Automates documentation for justified timing-based logic

03Implements reusable polling helpers with configurable intervals and timeouts

04Prevents CPU waste with optimized polling intervals

050 GitHub stars

06Supports waiting for events, state machine changes, and file system updates

Casos de Uso

01Refactoring flaky CI/CD pipelines that fail inconsistently across different environments

02Hardening asynchronous logic tests where execution order is non-deterministic

03Accelerating test suite performance by replacing fixed delays with immediate state detection

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kingly-agency/kingly-claude-adapter condition-based-waiting

For use in Claude.ai and ChatGPT