obai-model-benchmark

Benchmarks hub model and reasoning-effort combos by running the paid E2E regression gate per combo and ranking quality, cost, and latency.

11|6|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/sixteen-dev/obai --skill obai-model-benchmark-sixteen-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obai-model-benchmark
Source: https://github.com/sixteen-dev/obai/tree/main/.claude/skills/obai-model-benchmark
Command: npx skills add https://github.com/sixteen-dev/obai --skill obai-model-benchmark-sixteen-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve? Choosing which hub orchestrator model and reasoning-effort setting to ship is a high-stakes decision that ad-hoc testing cannot answer. This Skill runs the existing OBaI E2E regression gate once per candidate model:effort combo under a provably identical source tree, then ranks the reviewed outcomes on quality, dollar cost, and latency so the comparison is evidence-based rather than anecdotal. ## Core Features & Use Cases - Controlled multi-combo execution: Pins each hub model/effort pair via environment injection, scrubs inherited overrides, snapshots a source digest per run, and stops the session on the first failed combo. - Blind review and cross-combo audit: Reviews each run independently, then audits drafts across combos to surface disagreements before finalizing immutable reviewed results. - Fairness-gated ranking report: Refuses to rank runs whose suite fingerprint, cases snapshot, or source digest differ, applies a guardrail-failure disqualifier and a podium rule, and prices every span from a YAML rate table. - Use Case: When deciding whether to switch the hub default from gpt-5.6-terra:max to gpt-5.6-sol:high, run a smoke pass across candidates, then a core benchmark on the top two plus the incumbent, and read the scoreboard before proposing any settings change. ## Quick Start Ask the assistant to benchmark gpt-5.6-sol:high against gpt-5.6-terra:high on the core tier, starting with the offline dry run to confirm the plan and disclosed cost before authorizing paid execution.

Frequently Asked Questions about obai-model-benchmark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I benchmark hub model and reasoning effort combinations?▼

Run benchmark_suite.py with a comma-separated --combos list, a --tier of smoke or core, a session directory, and --max-api-calls-per-combo. Start with a dry run to validate the plan, then re-run with --execute after explicitly authorizing the disclosed total cost.

What model and effort combinations are valid for benchmarking?▼

Valid combos are the Cartesian product of HUB_MODELS and HUB_REASONING_EFFORTS from core_agents.hub_settings, currently gpt-5.6-sol and gpt-5.6-terra crossed with medium, high, xhigh, and max. Anything outside that whitelist is rejected, and duplicates or more than eight combos are refused.

Why does the benchmark refuse the live tier?▼

The live tier is a provider-freshness canary whose outcomes move with the market, so it cannot separate two models. Only the smoke and core tiers produce comparable, decision-grade evidence between combos.

Why does the benchmark fail with exit code 3?▼

Exit 3 is a fairness or took-effect violation, not a formatting problem. It means the runs are not comparable (differing cases snapshot, suite fingerprint, dirty flag, or source digest) or a combo's hub spans ran a different model or effort than claimed; fix the cause and rerun under fresh authorization.

Can I resume an interrupted benchmark session?▼

Yes, re-run with --resume-session --execute using the identical combos, tier, cap, and session directory. Completed combos are skipped, but a combo that published an incomplete results.json is refused and must be rerun in a fresh session directory.

When should I not use this benchmark skill?▼

Never invoke it as a side effect of a model or prompt change, since every combo is a full paid gate run. Use it only when the user explicitly asks to benchmark or choose between hub configurations, and never draw shipping conclusions from smoke-tier results alone.