evals

Generate characterization tests and Promptfoo eval suites for CI ship-gates.

115|13|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Houseofmvps/ultraship --skill evals-houseofmvps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evals
Source: https://github.com/Houseofmvps/ultraship/tree/main/skills/evals
Command: npx skills add https://github.com/Houseofmvps/ultraship --skill evals-houseofmvps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI-written code often passes code review but fails silently at runtime, and AI-powered features like chatbots, RAG systems, and classifiers drift in behavior as prompts or models change, leading to unexpected production issues that are hard to detect early.

Core Features & Use Cases

  • Characterization test generation: Locks the current observable behavior of code before refactoring to catch regressions immediately, supporting all common test runners like Vitest, Jest, and pytest.
  • LLM feature eval scaffolding: Builds Promptfoo eval suites to assert AI features stay on-topic, avoid PII leaks, match required formats, and meet latency thresholds on every code change.
  • Ship-gate integration: Wires eval runs into CI pipelines so failing tests block deployments, turning the regression suite into a mandatory code review step.

Quick Start

Use the evals skill to build a complete regression and eval test suite for the AI customer support chatbot in the ./src/chat directory before you update its underlying prompt logic.

Frequently Asked Questions about evals

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

FAQPage Schema
How do I prevent silent runtime failures when refactoring AI-generated code?

To prevent silent failures when refactoring AI-generated code, generate characterization tests to lock current observable behavior. This immediately catches regressions in AI-written code before deployment, integrating with common runners like Vitest, Jest, and pytest.

How do I test LLM features for prompt drift and format compliance in CI?

Test LLM features for prompt drift by building Promptfoo eval suites that assert chatbots stay on-topic, avoid PII leaks, match formats, and meet latency thresholds. Wire these evals into CI pipelines to block failing changes from deployment.

What is the best way to lock RAG system behavior before updating prompt logic?

The best way to lock RAG system behavior is generating Promptfoo eval suites to assert feature behavior. This creates regression tests ensuring your AI features remain stable and compliant before you update underlying prompt logic.

Can I use promptfoo evals as a mandatory ship-gate in my existing CI pipelines?

Yes, you can wire promptfoo evals and characterization test runs directly into your CI pipelines as mandatory ship-gates. This integration blocks deployments when tests fail, turning the regression suite into a required code review step.

Does characterization testing work with my existing Vitest or pytest test runners?

Yes, characterization testing supports all common test runners including Vitest, Jest, and pytest. It locks the current observable behavior of your codebase before refactoring, catching regressions immediately within your established testing environment.