adk-eval-guide

Diagnose ADK evaluation failures and recommend fixes for agent results.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/SeanChenR/maestro-agent --skill adk-eval-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adk-eval-guide
Source: https://github.com/SeanChenR/maestro-agent/tree/main/.agents/skills/adk-eval-guide
Command: npx skills add https://github.com/SeanChenR/maestro-agent --skill adk-eval-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guide reduces guesswork when ADK evaluation metrics fail by explaining evaluation metrics, evalset schemas, judge-model patterns, and common failure modes so engineers can diagnose, fix, and iterate on agent quality reliably.

Core Features & Use Cases

  • Metric guidance: Explains metric selection and configuration including tool_trajectory_avg_score, final_response_match_v2, rubric-based metrics, and hallucinations_v1.
  • Evalset & config patterns: Shows evalset schema, session overrides, multimodal and user-simulation schemas, and how to wire custom metrics and judge model options.
  • Debugging workflow: Provides an iterative eval-fix loop, common gotchas (google_search behavior, app name mismatches, non-determinism), and practical fixes for CI and local testing.

Quick Start

Run a focused evaluation using your evalset, inspect per-invocation metric breakdowns, and apply the recommended fixes to prompts, evalsets, or config until scores stabilize.

Frequently Asked Questions about adk-eval-guide

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

FAQPage Schema
How do I fix failing ADK agent evaluation metrics?

ADK agent evaluation metric failures are fixed by inspecting tool trajectories and LLM-as-judge outputs to diagnose common failure modes. Apply the iterative eval-fix loop to update prompts, evalsets, or eval_config.json until scores stabilize.

What is an LLM-as-judge rubric metric in ADK evaluations?

An LLM-as-judge rubric metric in ADK uses a model to score agent responses against defined criteria. Configure deterministic or rubric-based judge settings in eval_config.json for reproducible CI and local testing.

How do I configure eval_config.json for multimodal and user-simulation scenarios?

Configure eval_config.json for multimodal and user-simulation scenarios by defining the evalset schema and applying session overrides. This wires custom metrics and judge model options to test agent interactions reliably.

Why does my ADK evalset return non-deterministic results in CI?

ADK evalset non-determinism in CI often stems from google_search behavior or improper judge settings. Stabilize scores by applying practical fixes to config patterns and choosing deterministic or rubric-based judge configurations.

Does ADK evaluation support tool trajectory scoring?

Yes, ADK evaluation supports tool trajectory scoring via the tool_trajectory_avg_score metric. It evaluates agent tool usage patterns alongside final_response_match_v2 and hallucinations_v1 metrics for comprehensive quality assessment.