evals-skills README

The project's README from github.com/ai-evals-course/evals-skills. As one markdown file: README.md.

Eval Skills

Skills that guide AI coding agents to help you build product-specific AI evals (not foundation model benchmarks).

These skills guard against common mistakes we've seen helping 50+ companies and teaching thousands of students in our AI Evals course.

Why skills for evals

There are many easily avoidable footguns in evals. These skills help you avoid them.

evals-start is the entry point. It looks at your situation and routes you to the right skill. Most of the time it will send you to one of these two:

Installation

Install with npx skills:

npx skills add https://github.com/ai-evals-course/evals-skills

Install one skill only:

npx skills add https://github.com/ai-evals-course/evals-skills --skill error-discovery

Check for updates:

npx skills check
npx skills update

Available skills

Skill What it does
evals-start Entry point. Routes to the skill that matches your situation
eval-audit Audit an eval pipeline and surface problems with prioritized severity
error-discovery Build a review app, select diverse samples, and organize your notes into failure modes
generate-synthetic-data Create diverse synthetic test inputs using dimension-based tuple generation
write-judge-prompt Design LLM-as-Judge evaluators for subjective quality criteria
validate-evaluator Calibrate LLM judges against human labels using data splits, TPR/TNR, and bias correction
evaluate-rag Evaluate retrieval and generation quality in RAG pipelines
build-review-interface Build custom annotation interfaces for human trace review

The error-discovery skill

The error-discovery skill in the plugin is the most important. Error discovery involves qualitative and quantitative analysis of your traces to find failure modes. You should only write evals after doing this step.

This skill makes an AI agent run error analysis on a dataset. Point it at a JSONL/CSV/JSON file of LLM outputs or traces, and it:

  1. Reads the dataset and figures out the content type (articles, agent traces, code, structured output, etc.).
  2. Designs visual encoding based on what varies in the data. Uses Gestalt principles (color for categories, spacing for hierarchy, opacity for importance).
  3. Builds a single-file HTML review app served by a Python stdlib server. No dependencies.
  4. Clusters the data and picks a diverse initial sample (cluster reps + random picks).
  5. Runs an interactive loop: monitors annotations, categorizes failure modes, proposes new samples to increase coverage.

Error Discovery Skill Workflow

You read and leave free-text notes. The agent sorts them into failure modes, tracks coverage, and picks new samples to fill gaps.

Once installed, point the agent at a dataset:

Can you help me do error analysis on traces.jsonl?

Write your own skills

These skills encode common mistakes that generalize across projects. Skills grounded in your own data and domain will outperform them. Start here, then write your own. Matt Pocock's writing-for-ai-agents is a good resource.

Beyond these skills

These skills cover the parts of eval work that generalize across projects. Much of the process doesn't, such as production monitoring, CI/CD regression suites, and cost optimization. The AI Evals course covers those.

evals-skills (ai-evals-course/evals-skills)

Searching Database…

这是什么?一套智能体技能(agent skills),用来引导 AI 编程助手为具体产品构建 AI 评估(evals)——而不是基础模型基准测试。它凝聚了作者在 AI Evals 课程中从 50 多家公司和数千名学员那里看到的常见错误。
那这是我自己运行的工具,还是我的编程助手照着执行的说明?不是一个应用——而是一套由你的 AI 编程助手加载并遵循的技能。'evals-start' 是入口:它会分析你的情况,把你引导到合适的技能上。
怎么安装这些技能?运行 'npx skills' 即可安装到你的编程助手中。你也可以只安装某一个技能,并用另外的命令检查更新。
除了编程助手,还需要安装别的东西吗?不需要——用你现有的 AI 编程助手就行。唯一的运行时接触点是 error-discovery 生成的审阅页面:一个单文件 HTML 页面,由 Python 标准库服务器提供,零依赖。
这些技能不覆盖评估工作的哪些部分?只覆盖能跨项目通用的部分。生产环境监控、CI/CD 回归测试套件和成本优化都明确不在范围内——团队的 AI Evals 课程会讲这些。
我在做一个 AI 产品,但对评估完全没经验,该从哪里入手?这些技能面向为自己的产品构建评估的开发者,凝聚了帮助 50 多家公司、教过数千名学员过程中积累的错误经验。如果你已经有一条评估流水线,evals-start 会把你引到 eval-audit;如果你还有没分析过的对话记录(traces),则会引到 error-discovery。
这个集合里有哪些技能?八个:evals-start(入口,负责路由)、eval-audit(审计现有的评估流水线,按严重程度标出问题)、error-discovery(构建审阅应用,把对话记录归入各类失败模式)、generate-synthetic-data(基于维度的元组生成)、write-judge-prompt(设计 LLM-as-Judge 评估器)、validate-evaluator(用 TPR/TNR 和偏差校准把评估器与人工标注对齐)、evaluate-rag(检索和生成质量),以及 build-review-interface(自定义标注界面)。
为什么说 error-discovery 是最重要的技能?因为你应该先做错误分析,然后再写评估。你把它指向一个包含 LLM 输出或对话记录的 JSONL/CSV/JSON 文件:它会构建一个审阅应用,对数据聚类并挑选多样化的样本,然后进入交互式循环——你的自由文本笔记会被归入各种失败模式,同时它会挑选新样本填补覆盖空白。
为什么用技能,而不是直接读一篇评估指南?评估里有很多很容易踩的坑。这些技能把 AI Evals 课程团队在帮助 50 多家公司时看到的常见错误固化了下来,让你的智能体在为你的具体产品构建评估时能避开它们。
我可以写自己的评估技能吗?可以,而且作者也鼓励你这么做:这些技能只覆盖跨项目通用的内容,而扎根于你自己的数据和领域的技能效果会更好。Matt Pocock 的 writing-for-ai-agents 是一个不错的入门资源。
Size
1.7 MB
Stars
1.5K
Updated
CommitSep 24
Age
3mo
Commits · 90 Days