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…

Что это такое?Набор навыков (skills) для агентов, которые помогают AI-агентам для кодинга создавать AI-оценки под конкретный продукт — а не бенчмарки базовых моделей. В них заложены ошибки, которые авторы видели более чем в 50 компаниях и у тысяч студентов на своём курсе AI Evals.
То есть это инструмент, который я запускаю сам, или инструкции, которым следует мой агент для кодинга?Это не приложение — это набор навыков, которые ваш AI-агент для кодинга загружает и выполняет. 'evals-start' — входная точка: она оценивает вашу ситуацию и направляет вас к нужному навыку.
Как установить эти навыки?Выполните 'npx skills', чтобы установить их в ваш агент для кодинга. Можно установить и всего один навык, а проверять обновления — отдельными командами.
Нужно ли устанавливать что-то ещё, кроме агента для кодинга?Нет — достаточно вашего существующего AI-агента для кодинга. Единственный компонент времени выполнения — сгенерированное error-discovery приложение для ревью: одностраничный HTML-файл, который раздаётся сервером из стандартной библиотеки Python без каких-либо зависимостей.
Какие части работы с оценками эти навыки не охватывают?Только то, что универсально для любых проектов. Продакшн-мониторинг, регрессионные наборы для CI/CD и оптимизация затрат явно выходят за рамки — их разбирает курс AI Evals от этой команды.
Я делаю AI-продукт, но никогда не занимался оценками — с чего начать?Эти навыки рассчитаны на разработчиков, которые строят оценки для своего продукта, и в них заложены ошибки из опыта работы более чем с 50 компаниями и обучения тысяч студентов. evals-start направит вас к eval-audit, если пайплайн оценок у вас уже есть, или к 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 называют самым важным навыком?Потому что оценками стоит заниматься только после анализа ошибок. Вы указываете ему на JSONL/CSV/JSON-файл с выводами или трейсами LLM: он создаёт приложение для ревью, кластеризует данные и отбирает разнообразную выборку, а затем запускает интерактивный цикл — ваши заметки в свободной форме раскладываются по типам сбоев, пока он подбирает новые примеры, чтобы закрыть пробелы в покрытии.
Почему навыки, а не просто гайд по оценкам?В оценках легко наступить на одни и те же грабли. Навыки кодируют типичные ошибки, с которыми команда курса AI Evals сталкивалась, помогая более чем 50 компаниям, — так ваш агент обходит их стороной, строя оценки именно для вашего продукта.
Могу ли я написать свои навыки для оценок?Да, и авторы это только приветствуют: эти навыки покрывают лишь то, что универсально для любых проектов, а навыки, опирающиеся на ваши собственные данные и предметную область, будут работать лучше. Хорошая отправная точка — writing-for-ai-agents от Matt Pocock.
Size
1.7 MB
Stars
1.5K
Updated
CommitSep 24
Age
3mo
Commits · 90 Days