promptfoo-evaluation

Configure and run Promptfoo LLM evaluation workflows with YAML configs and CLI commands.

1.3k|212|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill promptfoo-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promptfoo-evaluation
Source: https://github.com/daymade/claude-code-skills/tree/main/promptfoo-evaluation
Command: npx skills add https://github.com/daymade/claude-code-skills --skill promptfoo-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams set up prompt testing configurations, run evaluations, and collect results using Promptfoo, including Python assertions and llm-rubric scoring.

Core Features & Use Cases

  • Setup promptfoo configurations and tests
  • Write Python custom assertions (metrics)
  • llm-rubric scoring with thresholds
  • Compare different models and prompts

Quick Start

  1. Initialize a new evaluation project with npx promptfoo@latest init
  2. Run evaluation with npx promptfoo@latest eval
  3. View results with npx promptfoo@latest view

Frequently Asked Questions about promptfoo-evaluation

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

FAQPage Schema
How do I set up and run LLM evaluations with Promptfoo?

LLM evaluations with Promptfoo involve initializing a project with npx promptfoo@latest init, configuring promptfooconfig.yaml with your prompts and test cases, then running npx promptfoo@latest eval to benchmark models and view results with npx promptfoo@latest view.

What is llm-rubric scoring and how does it grade LLM outputs?

llm-rubric scoring uses an LLM as a judge to evaluate model outputs against defined criteria and thresholds. Promptfoo applies rubric-based grading to automatically assess prompt quality and consistency across test cases without manual scoring.

Can I compare multiple language models and prompts in a single evaluation?

Yes. Promptfoo evaluations support comparing different models and prompt formats across varied test cases simultaneously, producing structured results that benchmark performance differences and help identify the best configuration.

How do I add custom metrics and assertions to my Promptfoo evaluation?

Promptfoo supports Python custom assertions as metrics. Write Python scripts that validate outputs against your criteria, then reference them in your evaluation configuration to extend built-in grading with domain-specific logic.

What file formats and configuration does Promptfoo use for evaluation projects?

Promptfoo uses YAML-based configuration (promptfooconfig.yaml) to define evaluation structure, file-based prompts and tests, and supports Python assertion scripts. This approach keeps evaluation projects version-controllable and reproducible.

Do I need to understand prompt engineering before setting up Promptfoo evaluations?

Promptfoo handles evaluation logistics, but understanding your prompts and test objectives helps you structure better configurations. No advanced programming is required—YAML configuration and optional Python assertions support teams of varying technical depth.