1
# Flaky Test Triage
2
3
The standard response to a flaky test is a retry annotation, which converts a real
4
signal into a slower green build. This workflow finds the cause instead. Almost all
5
flakiness comes from a short list of mechanisms, and each has a specific fix that makes
6
the test deterministic rather than merely quieter.
7
8
## When to use
9
10
- A test fails intermittently in CI and passes locally.
11
- Someone is about to add a retry or a sleep to make it stop.
12
- A whole suite has become untrustworthy and people have started ignoring red builds.
13
14
## Install
15
16
```bash
17
npx openagents-cli add openagents/flaky-test-triage
18
```
19
20
| Runtime | Installed to |
21
|---|---|
22
| `claude-code` | `.claude/skills/flaky-test-triage/` |
23
| `cursor` | `.cursor/rules/flaky-test-triage/` |
24
| `codex` | `.codex/skills/flaky-test-triage/` |
25
| `openai-agents` | `agents/flaky-test-triage/` |
26
| `langgraph` | `graphs/flaky-test-triage/` |
27
| `generic` | `.openagents/flaky-test-triage/` |
28
29
## What is in the package
30
31
- `WORKFLOW.md` - the procedure, from measuring the rate to proving the fix.
32
- `causes.md` - the mechanisms behind flakiness, each with its tell and its real fix.
33
34
## License
35
36
MIT
37