README badges
Your skill's badge shows its live SkillzBench benchmark number — the same one on your skill page — and updates itself whenever we re-bench. Add it once; it never goes stale.
The badge
Markdown (GitHub README)
[](https://skillzbench.com/skills/<slug>)
Append ?cost=1 to also show what the skill costs per task in agent spend — the honest full picture:
[](https://skillzbench.com/skills/<slug>)
HTML
<a href="https://skillzbench.com/skills/<slug>"><img src="https://skillzbench.com/api/badge/<slug>.svg" alt="SkillzBench benchmark" height="20"></a>
What it shows — and what it won't
- lift +Npp · verified — the reference-model benchmark result, verified when the CI excludes zero with a full-tier run.
- quality +N pts — when pass rates saturate, the headline is the blind judge's score delta instead.
- did not trigger — the agent never loaded the skill. That's the honest result; fix the description and it re-benches automatically.
- not benched yet — embed it anyway; it fills in when the daily queue reaches your skill.
We never inflate a badge: it reads the same numbers as the public methodology, including negative results. A skill that hurts performance shows a red negative — that's the product.