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/christofferbergj/agent-skills --skill principle-explain-the-numberIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a set of instructional principles for accurately measuring and interpreting performance and evaluation results. It contains no code, external dependencies, or security risks.
- 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/christofferbergj/agent-skills/principle-explain-the-number">View principle-explain-the-number on skillZs</a>