# Flaky Test Hunter

> Identify and stabilize flaky tests (seeds, time, isolation) without hiding failures. Use when this capability is needed.

- Skill: `tomevault-io/flaky-test-hunter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/flaky-test-hunter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/flaky-test-hunter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/flaky-test-hunter

---


1) Re-run the failing test(s) multiple times (and/or with randomized order if supported).
2) Determine the flake type: time, concurrency, ordering, shared state, external dependency.
3) Stabilize by:
   - Removing shared mutable state
   - Using deterministic seeds/time control
   - Hermetic fixtures/test doubles
   - Reducing reliance on network/timeouts
4) Add a regression test or harness that reproduces the flake deterministically if possible.
5) Re-run the relevant suite and document the root cause + fix in the feature spec Debug log.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/rafaie) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

