create-evals

Authors and runs eval Case entries for agents in an AgentOS platform.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/martin-cousseau/refund-arena --skill create-evals-martin-cousseau
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-evals
Source: https://github.com/martin-cousseau/refund-arena/tree/main/backend/.agents/skills/create-evals
Command: npx skills add https://github.com/martin-cousseau/refund-arena --skill create-evals-martin-cousseau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents built on the AgentOS platform are invisible to the eval suite until someone writes test cases for them. This Skill turns what an agent promises into concrete, runnable Case entries in evals/cases.py, grounded in real session data rather than guesswork. ## Core Features & Use Cases - Promise Mapping: Reads an agent's source file or published Studio config and converts every "always", "never", and "use X for Y" instruction into a testable case. - Session Mining: Queries Postgres for real user sessions and past eval runs to derive realistic test inputs and scenarios. - Case Authoring and Auditing: Writes Case entries with correct hooks, tags, and judge criteria, then runs them repeatedly to detect flaky or undecided rubrics. - Use Case: After building a customer-support agent in AgentOS Studio, run this Skill to generate smoke-tagged eval cases covering its core refund and escalation behaviors, then verify each case passes consistently before release. ## Quick Start Ask the agent to create eval coverage for your newly built agent, for example: "Create evals for my support agent covering its refund and escalation behavior."

Frequently Asked Questions about create-evals

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

FAQPage Schema
How do I create evals for an agent in AgentOS?▼

Run the create-evals workflow, which maps the agent's instructions into Case entries in evals/cases.py, mines Postgres sessions for realistic inputs, and runs each case with python -m evals --name to audit the verdict.

How do I write eval cases for a Studio-built agent with no source file?▼

Load the published config with Agent.load using the component id, or read it via eval_db.get_config. Guard the load because it returns None for archived or unpublished components, which would otherwise fail the whole suite at import.

What is the difference between create-evals and eval-and-improve?▼

create-evals authors new test coverage for agents that lack cases, while eval-and-improve repairs an existing failing suite. If the agent itself is wrong rather than the test, the improve-agent skill handles hardening.

Why does my eval case pass sometimes and fail other times?▼

A flipping verdict means the rubric is undecided, often due to vague judgment words. Run the case at least twice, check judge_reason with --json-output, and rewrite the criteria to be specific and falsifiable.

Can workflows be targets of eval cases in AgentOS?▼

No, workflows cannot be case targets. Cases accept an agent or a team, and a team must go in the team field since placing it in the agent field runs it misfiled without raising an error.