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.