
ai-evals
Help users build robust infrastructure for measuring, monitoring, and iterating on AI product performance using human, code-based, and LLM-as-a-judge methodologies.
- Installs
- 2.1K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/refoundai/lenny-skills --skill ai-evals- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads ai-evals automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
AI Evaluation Strategy
Move beyond vibe checks to systematic, empirical measurement of AI product quality and reliability.
Help the user with ai evaluation strategy using insights from 11 guests and posts across Lenny's Podcast and Newsletter.
How to Help
- Identify Failure Modes - Help the user conduct error analysis on real traces to find where the system specifically breaks.
- Select Eval Methods - Recommend the right mix of human, code, and LLM judges based on the specific technical use case.
- Build Gold Sets - Assist in curating a reference dataset of high-quality examples to act as the ground truth for your application.
- Operationalize - Guide the user in integrating these evaluations into a CI/CD pipeline for continuous quality improvement.
Core Principles
Automate the Value Chain
Brendan Foody: "I think that for enterprises especially, the core way to think about it is how can they build a test or systematic way to measure how well AI automates their core value chain? So if it's an architecture firm that's producing these architecture diagrams of what they provide to their end customer, how can they effectively measure that? And each company has its own value chain or maybe a handful of them if it's a multi-product company."
Identify the core deliverables unique to your business and develop systematic tests to measure how accurately AI can replicate those specific tasks.
Prioritize Subjective Excellence
Edwin Chen: "We are looking for a Nobel Prize-winning poetry. Is this poetry unique? Is it full of subtle imagery? Does it surprise you and target your heart? Does it teach you something about the nature of moonlight?"
True data quality is defined by deep, subjective human excellence, such as emotional resonance and uniqueness, rather than superficial binary checks.
Eliminate Vibe Checks
Hamel Husain & Shreya Shankar: "Evals help you create metrics that you can use to measure how your application is doing and kind of give you a way to improve your application with confidence. That you have a feedback signal in which to iterate against."
Create systematic metrics to track application quality over time, allowing teams to iterate on prompts or models with the same confidence as traditional software.
Structured Judge Logic
From "Beyond vibe checks: A PM’s complete guide to evals": "Clearly articulating what you want your judge-LLM to measure isn’t just a step in the process; it’s the difference between a mediocre AI and one that consistently delights users. Building these writing skills requires practice and attention."
Write effective automated evaluations by using a structured prompt that defines the role, data, success criteria, and specific labels for the judge.
Templates & Frameworks
- LLM-as-a-Judge Playbook (Building eval systems that improve your AI product) - A systematic three-step process for building, validating, and measuring an LLM judge that provides trusted binary pass/fail metrics for subjective AI quality as
- Three Eval Approaches (Human, Code-based, LLM-based) (Beyond vibe checks: A PM’s complete guide to evals) - A decision framework for choosing the right eval approach based on your use case, with pros and cons for each.
- The Eval Formula (Four-Part Structure) (Beyond vibe checks: A PM’s complete guide to evals) - A four-part formula for writing effective LLM-based eval prompts that any PM can use to construct judge-LLM prompts.
- Open Coding and Axial Coding for AI Error Analysis (Building eval systems that improve your AI product) - A qualitative research methodology adapted for AI product evaluation, used to discover and categorize failure modes from user interaction data.
- RAG Evaluation Framework (Retriever + Generator) (Building eval systems that improve your AI product) - A two-part evaluation approach for RAG systems that separately assesses the retriever and generator components with specific metrics for each.
- AI Eval Improvement Flywheel (Building eval systems that improve your AI product) - The closed-loop process that uses CI safety nets and production discovery engines together to create continuous AI product improvement.
- Reference Dataset Structure (Why your AI product needs a different development lifecycle) - A template for building the initial reference dataset (20-100 examples) to break the cold start and provide a baseline for AI system evaluation.
- Transition Failure Matrix for Agentic Workflows (Building eval systems that improve your AI product) - A diagnostic tool for pinpointing exactly which step in an agent's multi-step workflow breaks down, enabling data-driven debugging.
See references/artifacts.md for the full list with details.
Questions to Help Users
- "What are the top 3 to 5 failure modes your users are currently experiencing in production?"
- "Do you have a single domain expert or benevolent dictator who defines what quality looks like for this feature?"
- "What percentage of your current evaluation process is manual versus automated?"
- "Is your system non-determinism primarily occurring in the retrieval or the generation phase?"
- "Have you established a golden dataset of at least 20 to 50 human-labeled examples yet?"
- "How do you currently measure the performance delta when you switch models or change a system prompt?"
Common Mistakes to Flag
- Relying on vibe checks - Manual and anecdotal testing leads to inconsistent quality and hidden regressions that damage user trust over time.
- Obsessing over prompt engineering - Focusing solely on prompts while neglecting the underlying evaluation system prevents teams from scaling or hill-climbing systematically.
- Using generic metrics for product reporting - Off-the-shelf scores are useful for filtering but often fail to capture the specific value or failures unique to your business logic.
- Ignoring component isolation - Failing to evaluate the retriever separately from the generator in RAG systems makes it impossible to know which part of the stack is failing.
- Neglecting non-determinism - Failing to account for the stochastic nature of LLMs leads to false confidence in results that may not repeat in production.
Deep Dive
For all 33 sourced insights from 11 guests, see references/guest-insights.md
Related Skills
- Ai Product Strategy
- Ai Native Ux
FAQ
What does the ai-evals skill do?
Help users build robust infrastructure for measuring, monitoring, and iterating on AI product performance using human, code-based, and LLM-as-a-judge methodologies.
How do I install ai-evals?
Run npx skills add https://github.com/refoundai/lenny-skills --skill ai-evals in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ai-evals/ (personal) or .claude/skills/ai-evals/ (project).
Which AI agents can use ai-evals?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is ai-evals safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains ai-evals?
It is published by refoundai in refoundai/lenny-skills. It has 2,099 recorded installs.
More from refoundai/lenny-skills
personal-productivity
refoundai/lenny-skills
Help users manage their time and tasks more effectively. Use when someone is overwhelmed with work, struggling with focus, trying to balance multiple responsibilities, or asking how to get more done.
writing-prds
refoundai/lenny-skills
Help users transform abstract ideas into actionable project specs that align engineering and design teams on the problem and success metrics.
ai-product-strategy
refoundai/lenny-skills
Help users decide where to apply AI effectively, manage the transition from deterministic to probabilistic software, and build long-term defensibility through verticalization and proprietary data.
competitive-analysis
refoundai/lenny-skills
Help users understand and respond to competition. Use when someone is positioning against competitors, evaluating market threats, running competitive war games, or deciding how much to focus on competitors versus customers.
founder-sales
refoundai/lenny-skills
Help users master the transition from product development to active selling by leveraging their unique status as founders to bridge the trust gap and define a scalable sales motion.
analyzing-user-feedback
refoundai/lenny-skills
Help users convert massive volumes of qualitative and quantitative feedback into high-confidence product decisions through rigorous synthesis and internal immersion.
Popular ai & agents skills
google-agents-cli-publish
google/agents-cli
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
google-agents-cli-eval
google/agents-cli
This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).
skill-creator
anthropics/skills
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
codex-pet
prime-skills/runcomfy-agent-skills
Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.
full-output-enforcement
leonxlnx/taste-skill
Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
executing-plans
obra/superpowers
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available