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.