promptfoo-evals

Automate creation and maintenance of promptfoo evaluation suites, prompts, tests, assertions, and provider configurations.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill promptfoo-evals-gerald-ica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promptfoo-evals
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/promptfoo-evals
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill promptfoo-evals-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates or updates promptfoo evaluation suites, prompts, tests, assertions, and provider configs to streamline eval coverage and debugging.

Core Features & Use Cases

  • Create or refine maintainable promptfoo evaluation suites.
  • Generate and adjust prompts, tests, and assertions; configure providers.
  • Scaffold new eval matrices and extend coverage for different models and scenarios.

Quick Start

Create a new eval suite by placing a config in evals/my-suite and adding prompts, tests, and assertions.

Frequently Asked Questions about promptfoo-evals

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

FAQPage Schema
How do I create a promptfoo evaluation suite for testing prompts?

To create a promptfoo evaluation suite, you place a configuration file in the evals/ directory and add corresponding prompts, tests, and assertions. This automates eval coverage and streamlines debugging across different models.

How do I debug prompt regressions using promptfoo tests and assertions?

Debug prompt regressions by updating your promptfoo tests and assertions within the existing eval suite configuration. This allows you to isolate failing scenarios and refine prompts to restore deterministic outputs.

Can I scaffold a new evaluation matrix across multiple models with promptfoo?

Yes, you can scaffold a new evaluation matrix across multiple models by configuring providers and extending test coverage. This generates diverse scenarios and configs within the evals/ directory structure.

What file layout is required to configure promptfoo providers and assertions?

Configuring promptfoo providers and assertions requires a well-defined file layout including evals/, prompts/, tests/, and provider configuration files. This structure ensures deterministic prompts and organized test coverage.

When do I need to add promptfoo assertions to my eval tests?

You need to add promptfoo assertions to eval tests when you require deterministic validation of prompt outputs. Assertions help define specific expected results to prevent regressions and maintain output quality.

What is the best way to organize promptfoo prompts and tests for continuous evaluation?

The best way to organize promptfoo prompts and tests is maintaining a structured evals/ directory with separate prompts, tests, and provider configurations. This ensures maintainable evaluation suites and scalable coverage.