run-evals

Run existing skill evaluations via npx snapeval eval and parse benchmark results.

1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/matantsach/snapeval --skill run-evals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-evals
Source: https://github.com/matantsach/snapeval/tree/main/skills/run-evals
Command: npx skills add https://github.com/matantsach/snapeval --skill run-evals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run and manage existing skill evaluations to accelerate iteration and improve skill quality.

Core Features & Use Cases

  • Run evals when evals.json exists to validate current skill performance.
  • Re-evaluate after skill changes and compare iterations to measure impact.
  • Review results, surface patterns (always-pass, always-fail, differentiating), and propose concrete improvements.
  • Add or modify eval cases in evals.json while preserving existing ones and controlling execution with --only.

Quick Start

Run the existing eval suite for this skill and report the results.

Frequently Asked Questions about run-evals

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

FAQPage Schema
How do I run skill evaluations using an existing evals.json file?

Run skill evaluations by invoking npx snapeval eval with your skill path. The process parses benchmark results, surfaces patterns like always-pass or always-fail cases, and proposes concrete improvements to accelerate iteration.

How do I compare skill evaluation iterations after making changes?

Re-evaluate iterations by running the evaluation suite after skill changes. The workflow parses benchmark results to measure impact, surfaces differentiating patterns, and proposes concrete improvements to optimize skill quality.

Can I gate CI pipelines using snapeval benchmark results?

Yes, you can gate CI by running snapeval eval to generate benchmark results. The evaluation workflow orchestrates this process, parsing outcomes and surfacing patterns to validate skill performance before deployment.

How do I add new eval cases to evals.json without losing existing ones?

Add or modify eval cases directly in evals.json while preserving existing ones. Control execution scope using the --only flag, then run snapeval eval to validate the updated suite and review benchmark results.

Do I need an existing evals.json file to run skill evaluations?

Yes, an existing evals/evals.json file is required. The evaluation workflow applies when the target skill already has evals defined, orchestrating npx snapeval eval to run benchmarks and surface performance patterns.

What patterns should I look for when reviewing skill benchmark results?

Review benchmark results for always-pass, always-fail, and differentiating patterns. Surfacing these patterns helps identify evaluation gaps and propose concrete improvements to optimize skill performance during iteration.