Promptfoo LLM Evaluation Setup
A skill that guides you through configuring and running prompt tests and model comparisons with Promptfoo.
Dev & CodingIntermediate★ 1,323⑂ 212AI score 8/10Last updated: Aug 8, 2026
What it does
- Scaffolds a working
promptfooconfig.yaml(prompts, providers, tests, defaultTest, outputPath). - Shows how to write Python custom assertions (
get_assertand named functions),llm-rubricLLM-as-judge checks, and common assertion types likecontains,regex, andlatency. - Covers multi-turn few-shot prompt patterns in chat.json and the echo provider for previewing rendered prompts with zero API cost.
- Documents real gotchas:
apiBaseUrlbelongs inproviders[].config,maxConcurrencymust sit undercommandLineOptions,file://paths resolve from the config root, and graders need their own provider behind a relay.
Who it's for
- AI app developers who want regression tests for prompt quality instead of eyeballing outputs.
- Teams comparing Claude, GPT, and other models on a shared test set.
- Anyone calling LLM APIs through a corporate relay/proxy and fighting promptfoo config issues.
Examples
- "Set up a promptfoo project to evaluate my summarization prompt" → generates config, tests/cases.yaml, scripts/metrics.py.
- "Write a Python assertion that passes when the reduction ratio is 70–90%" → a
check_lengthfunction that strips HTML then computes the ratio. - "My llm-rubric returns 401 through our relay" → diagnosis that each rubric needs its own
provider.config.apiBaseUrl.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/promptfoo-evaluation/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the promptfoo-evaluation folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/promptfoo-evaluation/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/promptfoo-evaluation ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and go to your working directory.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r claude-code-skills/promptfoo-evaluation ~/.claude/skills/ - Make sure Node.js (npx) and Python 3 are installed; set
export PROMPTFOO_PYTHON=python3if needed. - Export the API keys you plan to use (
ANTHROPIC_API_KEY,OPENAI_API_KEY, etc.). - Restart Claude Code and ask something like "set up a promptfoo evaluation for my prompt" to trigger the skill.
View source on GitHub ↗License: MIT