arch-benchmark

Runs benchmark scenarios against a rubric and reports scores from frontier model judges.

89|10|Updated Sep 15, 2026
One-click install
npx skills add https://github.com/baristaze/swe_guidelines --skill arch-benchmark-baristaze
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-benchmark
Source: https://github.com/baristaze/swe_guidelines/tree/main/skills/arch-benchmark
Command: npx skills add https://github.com/baristaze/swe_guidelines --skill arch-benchmark-baristaze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Measuring whether a change to a skill or guideline text actually improves it requires repeatable, multi-provider evaluation, which is slow and error-prone to orchestrate by hand. ## Core Features & Use Cases - Scenario Execution: Runs a declared benchmark scenario (a skill, command, or question) via benchmark/run.py in a guideline repository checkout, with configurable judges, effort, repeats, and runtime (host, container, or vm). - Multi-Provider Judging: Scores the subject with frontier models from Anthropic, OpenAI, Gemini, and xAI, selected by bit flag or comma-joined names, and reports per-provider scores plus the overall mean. - Dry-Run Planning: Resolves the full run plan with --dry-run, writing run.json without calling any provider, so you can verify the subject command, judges, and fallbacks before spending money. - Use Case: After editing a review skill, run the explain-tenancy scenario with all four judges to see whether the change raised the rubric score before shipping it. ## Quick Start Run the explain-tenancy benchmark scenario with all four judges and one repeat, then summarize the report.

Frequently Asked Questions about arch-benchmark

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

FAQPage Schema
How do I benchmark a Claude Code skill against a rubric?▼

Run `uv run benchmark/run.py --scenario <name>` from a checkout of the guideline repository. The harness executes the subject, has the selected frontier model judges score it against the rubric, and writes a report.md with per-provider scores and findings.

How do I preview a benchmark run without calling providers?▼

Add the `--dry-run` flag to the run command. It resolves the scenario, runtime, judges, effort, and repeats, writes run.json, and calls nothing, so you can inspect the full plan before a paid measurement run.

Which model providers can judge a benchmark run?▼

Judges come from Anthropic, OpenAI, Gemini, and xAI, selected with a bit flag (3, 7, 15) or comma-joined names. A provider whose API key is absent is skipped and reported as absent rather than treated as a failure.

Can the benchmark run a skill inside a container?▼

Yes, `--runtime container` executes the subject with docker run from an image the harness builds. The first run on a machine needs `--build`, and later runs need it again only when the image's inputs changed.

Why does a benchmark run refuse to start in strict mode?▼

A skill scenario needs SUBJECT_ANTHROPIC_API_KEY to execute the subject. Without that key present, a `--strict` run refuses to start, since the subject itself cannot be invoked.