eval-harness

Run pytest tests and pipeline simulations to verify feature behavior.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/exerias21/brainstorm-toolkit --skill eval-harness-exerias21
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eval-harness
Source: https://github.com/exerias21/brainstorm-toolkit/tree/main/skills/eval-harness
Command: npx skills add https://github.com/exerias21/brainstorm-toolkit --skill eval-harness-exerias21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluating feature implementations requires running tests and simulating the pipeline to ensure correctness; this Skill provides a structured, repeatable workflow.

Core Features & Use Cases

  • Layered validation with pytest tests for logic and a pipeline simulation for end-to-end behavior.
  • Generates structured JSON results to compare expected vs actual outputs.
  • Useful for pre-PR checks, CI validation, and quick feature verification.

Quick Start

Run the eval harness to execute tests and simulate the feature pipeline, producing structured JSON results for review.

Frequently Asked Questions about eval-harness

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

FAQPage Schema
How do I automate pytest feature testing with structured JSON output?▼

You can automate pytest feature testing with structured JSON output by running a pipeline simulation that validates features against known inputs and expected results, generating structured JSON to compare actual versus expected behavior.

What is the best way to run end-to-end feature evaluation before a pull request?▼

End-to-end feature evaluation before a pull request is best handled by running pytest tests alongside a pipeline simulation, using fixture data and expected outputs to verify correctness and produce structured JSON results for quick review.

Do I need a specific directory structure to run pytest feature evaluations?▼

Yes, pytest feature evaluations require a defined evals/ directory structure to locate features, fixtures, and expected results, along with an eval runner configuration in .claude/project.json to automate the workflow.

Can I use fixture data to validate modified features against expected outputs?▼

You can use fixture data to validate modified features by running pytest tests that compare known inputs against expected outputs, applying layered validation to ensure both logic correctness and end-to-end pipeline behavior.

Why does my pipeline simulation fail to generate structured JSON results?▼

Pipeline simulation fails to generate structured JSON results when the eval runner configuration in .claude/project.json is missing or the evals/ directory structure cannot properly locate the required features, fixtures, and expected outputs.

Does eval-harness work for CI validation and quick feature verification?▼

Eval-harness works for CI validation and quick feature verification by automating end-to-end feature evaluation through pytest tests and pipeline simulation, producing structured JSON results that compare expected versus actual outputs.