About perf-theory-tester
A skill for testing performance hypotheses through controlled experiments. It changes one thing at a time, runs at least two validation passes, records evidence, and restores the baseline before the next experiment.
Key features
- 01Confirms a clean baseline
- 02Tests one change per experiment
- 03Runs at least two validation passes
- 04Reverts before the next experiment
- 05Records run evidence
Use cases
- 01Evaluate a performance hypothesis
- 02Compare a single change against a clean baseline
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ agent-sh/ agentsys --skill perf-theory-testerAfter installing, type/perf-theory-testerin Claude Code to confirm it loaded.
Details
From the project READMEperf-theory-tester
Test hypotheses using controlled experiments.
Follow docs/perf-requirements.md as the canonical contract.
Required Steps
- Confirm baseline is clean.
- Apply a single change tied to the hypothesis.
- Run 2+ validation passes.
- Revert to baseline before the next experiment.
Output Format
hypothesis: <id>
change: <summary>
delta: <metrics>
verdict: accept|reject|inconclusive
evidence:
- command: <benchmark command>
- files: <changed files>
Constraints
- One change per experiment.
- No parallel benchmarks.
- Record evidence for each run.
Comments
Markdown supported