eval-run

Evaluate output files against evals.yaml assertions and generate per-assertion score reports.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill eval-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-run
Source: https://github.com/petrSimonidesXart/xPmGateway/tree/main/.gaai/core/skills/cross/eval-run
Command: npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill eval-run

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Evaluates an AI or skill output against a structured evals.yaml by producing a transparent, per-assertion score report to help detect regressions and measure output quality.

Core Features & Use Cases

  • Load an output file and a corresponding evals.yaml and verify all assertions (code and llm-judge) deterministically or via LLM judgment.
  • Generate a structured report showing PASS/FAIL per assertion, total scores, and details for failures, suitable for auditing skill performance across releases.
  • Use cases include baseline scoring after changes, before/after quality comparisons, and automated quality gates in Skill Optimize workflows.

Quick Start

Run the eval-run skill by supplying the produced output file and its evals.yaml to generate a structured per-assertion score report.

Frequently Asked Questions about eval-run

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

FAQPage Schema
How do I evaluate AI output quality against a yaml file?

To evaluate AI output quality, you run an automated evaluation against a structured evals.yaml file to generate a per-assertion score report. This process applies across any skill domain to deterministically measure output quality and detect regressions.

What is the best way to detect regressions after instruction changes in my workflow?

Detecting regressions after instruction changes is achieved by running an evals.yaml evaluation before and after modifications. This produces a structured before/after quality comparison report showing PASS/FAIL per assertion and total scores.

Can I use both deterministic code and llm-judge assertions to evaluate output?

Yes, you can evaluate output using both deterministic code and llm-judge assertions. The evaluation verifies all assertions within the evals.yaml format and returns a machine-readable score report detailing any failures.

How do I generate a per-assertion score report for auditing skill performance?

Generating a per-assertion score report for auditing skill performance involves supplying an output file and its corresponding evals.yaml. The evaluation produces a human-friendly report with PASS/FAIL details suitable for automated quality gates.

Does the evals.yaml format validation enforce strict syntax rules?

Yes, the evals.yaml format validation enforces strict syntax rules before running assertions. This ensures that the structured evaluation can reliably apply code and llm-judge assertions without processing errors.

When do I need an automated quality gate for skill optimization?

You need an automated quality gate for skill optimization when you want to baseline scoring after instruction changes. Running an evals.yaml evaluation provides a structured score report to prevent quality degradation across releases.