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.