bat-story-eval

Compare MCP tool behavior across versions using diff-based story evaluation.

4.3k|185|Updated Sep 14, 2025
One-click install
npx skills add https://github.com/homeassistant-ai/ha-mcp --skill bat-story-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bat-story-eval
Source: https://github.com/homeassistant-ai/ha-mcp/tree/main/.claude/skills/bat-story-eval
Command: npx skills add https://github.com/homeassistant-ai/ha-mcp --skill bat-story-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables structured evaluation by comparing MCP tool behavior across software versions using a mix of pre-built stories and custom tales, highlighting regressions and drift.

Core Features & Use Cases

  • Triage changes and select representative stories based on diff impact
  • Design custom stories to exercise new code paths and potential regressions
  • Document and compare results across baseline and target versions for traceability

Quick Start

Run the BAT evaluation workflow against a baseline and target to compare MCP tool behavior.

Frequently Asked Questions about bat-story-eval

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

FAQPage Schema
How do I benchmark MCP tool behavior across software versions?

Benchmark MCP tool behavior by comparing target runs against a baseline using pre-built and custom stories with diff-based evaluation. This highlights regressions and behavioral drift for traceable regression detection.

What is diff-based evaluation for MCP regression testing?

Diff-based evaluation for MCP regression testing compares the outputs of baseline and target tool versions using structured stories. It validates analysis workflows to ensure traceable detection of behavioral changes.

How do I triage changes and select stories based on diff impact?

Triage changes by selecting representative pre-built stories based on diff impact, or design custom stories to exercise new code paths. This ensures targeted evaluation of potential regressions across versions.

Can I document and compare MCP results across baseline and target versions?

Yes, you can document and compare results across baseline and target versions. The evaluation workflow validates story catalogs and reporting workflows to ensure traceability throughout the regression detection process.

When do I need custom stories for MCP tool evaluation?

You need custom stories when triaging changes and pre-built stories are insufficient to exercise new code paths. Designing custom tales allows you to target potential regressions and validate specific behavior across baseline and target comparisons.

What are the limitations of diff-based story evaluation for MCP tools?

Diff-based story evaluation requires both a baseline and target run to compare MCP tool behavior. Without establishing a baseline, the evaluation cannot detect regressions or validate story catalogs for traceable reporting.