eval-guide

Define agent purpose, success criteria, and evaluation scope into test artifacts.

123|20|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/microsoft/eval-guide --skill eval-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eval-guide
Source: https://github.com/microsoft/eval-guide/tree/main/skills/eval-guide
Command: npx skills add https://github.com/microsoft/eval-guide --skill eval-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @anthropic-ai/sdk, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a structured, end-to-end evaluation accelerator that helps teams articulate an agent's purpose, success criteria, and evaluation scope early, turning vague ideas into a concrete eval plan and test artifacts.

Core Features & Use Cases

  • Agent Vision to plan mapping: guides discovery conversations to produce a precise Agent Vision and risk profile.
  • Stage-aligned planning: converts the vision into Stage 1 acceptance criteria, including a Value × Cost-of-Failure matrix and pass/fail conditions.
  • Evidence-ready test artifacts: generates Stage 2 test cases (CSV) and Stage 1 docs that import into Copilot Studio, with dashboards for review.
  • Triage-ready outputs: Stage 4 triage guidance and root-cause classification when eval results arrive.

Quick Start

Describe your agent and run through Stage 0 to produce a ready-to-use eval plan.

Frequently Asked Questions about eval-guide

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

FAQPage Schema
How do I create acceptance criteria for agent evaluation early in the product lifecycle?▼

Agent evaluation planning starts by defining the agent's purpose, success criteria, and evaluation scope. This Skill converts your agent vision into Stage 1 acceptance criteria, including a Value × Cost-of-Failure matrix and pass/fail conditions.

How do I generate test cases for Copilot Studio agents?▼

You can generate evidence-ready test artifacts by running your agent concept through the evaluation planner. It produces Stage 2 test cases in CSV format and Stage 1 documentation that import directly into Copilot Studio for review.

What is stage-based evaluation for AI agents and when do I need it?▼

Stage-based evaluation is a structured framework that breaks agent assessment into Stage 0 through Stage 4 outputs. You need it when planning evals, generating test cases, interpreting results, and triaging failures for an agent concept or feature improvement.

How do I triage agent evaluation failures and classify root causes?▼

Agent evaluation triage uses Stage 4 guidance to classify root causes when eval results arrive. It provides structured triage-ready outputs that help you interpret failures and identify why an agent concept or feature did not meet acceptance criteria.

Can I use this evaluation guide without prior test artifacts or documentation?▼

Yes, the evaluation accelerator turns vague ideas into a concrete eval plan starting from Stage 0. You simply describe your agent concept and run through the discovery conversations to produce a ready-to-use plan without pre-existing test artifacts.

Do I need the Anthropic SDK to run agent evaluation scripts?▼

Yes, the evaluation scripts depend on the Anthropic SDK to function. You must have the @anthropic-ai/sdk installed in your environment to execute the stage-based evaluation and test case generation processes.