run-evals

Orchestrates full eval rounds on the stellar-raven MCP server from CLI agents.

8|6|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/stellar-experimental/stellar-raven --skill run-evals-stellar-experimental
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-evals
Source: https://github.com/stellar-experimental/stellar-raven/tree/main/.agents/skills/run-evals
Command: npx skills add https://github.com/stellar-experimental/stellar-raven --skill run-evals-stellar-experimental

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running a trustworthy evaluation of the stellar-raven-codemode MCP server requires coordinating routing gates, paid QA batteries, live-data lanes, judge models, budget caps, and failure triage — a process that is easy to get wrong and expensive to redo. This Skill provides a step-by-step runbook that keeps every eval round methodologically sound and cost-controlled. ## Core Features & Use Cases - Instrument selection and gating: Maps each type of change (scoring, catalog, executor, prompt surface) to the right eval lane — routing gate, QA headline sample, agentic lane, plan regrade, or live-data contract — with free preflight checks before any paid spend. - Agent role separation and budget enforcement: Distinguishes the orchestrating agent from spawned answering and judge agents, and enforces fail-closed --max-budget-usd caps, server-revision pins, and remote-identity probes on every paid run. - Verdict review and upstream findings: Requires agentic review of every wrong/partial verdict against live services, root-cause triage, and filing evidence-backed findings in improvements/ — the primary artifact of every round. - Use Case: After changing the search catalog, ask your CLI agent to run evals; it will run the routing gate, launch a budgeted QA sample against a pinned dev server, review judge verdicts, and file upstream gaps. ## Quick Start Ask your agent to run a full eval round on stellar-raven-codemode using the run-evals skill, starting with the free preflight and routing gate.

Frequently Asked Questions about run-evals

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

FAQPage Schema
How do I run evals on the stellar-raven MCP server?▼

Start with the free preflight commands (eval:selftest, eval:compile, eval:qa:lint), then run the routing gate. For paid QA lanes, boot a dev server with npm run dev:eval and invoke eval/qa/run-qa.mjs with a budget cap, server revision, and surface hash.

Which eval instrument should I run for a scoring or catalog change?▼

Any scoring, catalog, or manifest change requires the routing gate, which is free and takes seconds. Larger answer-quality changes add a QA battery sample, executor changes add the live-data lane, and prompt-surface changes add a plan regrade.

How are eval costs controlled during a QA run?▼

Every paid command requires exactly one --max-budget-usd flag; the harness sends only the remaining authorized amount to each call and stops when exhausted. Cost estimates must come from stored result files, not README per-case figures.

Can I trust the judge verdicts from a QA eval run?▼

No — judge verdicts are evidence, not ground truth. Every wrong verdict must be live-verified by re-executing the claim against the service, and isolated flips should be re-judged once to rule out variance before counting them as agent failures.

What is the difference between the orchestrating, answering, and judge agents?▼

The orchestrating agent runs the runbook, servers, and triage. The answering agent is spawned per QA case via headless claude -p with only the MCP tools, and the judge agent grades each candidate answer against the golden. Defaults are claude-sonnet-5 for both.

Why did my QA run get marked non-comparable?▼

Runs are marked non-comparable when the server revision, surface hash, or remote-identity probe changes mid-run, or when the final check fails. The runner preserves completed rows but suppresses aggregates, and the artifact cannot be resumed under the same authorization.