principle-explain-the-number
Apply before you measure, and before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.
How do I install this agent skill?
npx skills add https://github.com/backnotprop/pstack --skill principle-explain-the-numberIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is purely instructional and provides a set of principles for explaining and verifying measured numbers such as performance benchmarks and evaluation results. It contains no executable code, shell commands, or network operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Explain the Number
- Write the decision before you run. Name the result that would change it, and the noise floor. Stop when the run-to-run spread is larger than the effect.
- Ask "why not double?" Name the resource or code path that bounds the result, from a profile or counters taken during a run. A guess from reading the code is not a limiter.
- List what else the number could be measuring (errors, skipped or cached work, code that never ran, an untuned side, noise, a piece too small to matter) and rule out each one with evidence.
- Keep the run count, the spread, and the limiter with the number.
For a performance number, run the benchmark-checklist skill. For an eval result, ask whether every run did the task, whether the gap holds across trials and models, and whether the scenario matters.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/backnotprop/pstack/principle-explain-the-number">View principle-explain-the-number on skillZs</a>