eval-engineering

Build and audit Harbor-based agent evaluation tasks with reusable project knowledge.

1.2k|90|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/langchain-ai/langchain-skills --skill eval-engineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-engineering
Source: https://github.com/langchain-ai/langchain-skills/tree/main/config/skills/eval-engineering
Command: npx skills add https://github.com/langchain-ai/langchain-skills --skill eval-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Designing fair, reproducible agent evaluations is hard: tasks leak hidden answers, verifiers accept wrong results, environments fail to reset, and pass rates get misread as quality. This Skill provides a disciplined end-to-end workflow for turning an agent repository and optional traces into reviewed Task Specs, audited Harbor tasks, and reusable project World Knowledge Skills.

Core Features & Use Cases

  • Spec-driven task design: Inspect the repository, harness, and traces, then draft a human-reviewed Task.md spec alongside a project World Knowledge Skill before any implementation.
  • Spec2Task implementation and audit: Build the Harbor task package (instruction, environment, verifier, optional solution), run package completeness audits, and validate verifier behavior against valid, wrong, shortcut, and corrupt-evidence cases.
  • Calibration and failure classification: Read full run trajectories and classify failures as capability, harness, environment, verifier, leakage, or infrastructure issues before trusting any score.
  • Use Case: You maintain a customer-support agent and want a benchmark. Use this Skill to mine traces, propose a policy-bound refund task, build its simulated environment and verifier, run the real harness, and reconcile what you learned into a reusable World Skill for future tasks.

Quick Start

Use the eval-engineering skill to inspect my agent repository and draft one Task Spec with its project World Skill for my review.

Frequently Asked Questions about eval-engineering

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

FAQPage Schema
How do I create an agent evaluation task with Harbor?

Follow the eval-engineering flow: inspect the repository and traces, draft a reviewed Task.md spec, then build the Harbor package with task.toml, instruction.md, an environment definition, and tests/test.sh as the verifier entry point. Audit the package before any scored model run.

How do I design a fair verifier for an agent benchmark?

Build independent checks that read final environment state rather than agent claims, and test the verifier with a valid result, a valid alternative, a wrong result, a shortcut, a collateral change, and missing evidence. Every completed verifier path must write a parseable reward without exposing hidden truth.

What is a World Knowledge Skill in agent evals?

It is a repository-local skill that stores reusable project-specific knowledge such as environment methods, data creation patterns, and verifier evidence. It helps generate future Task Specs while exact task truth stays in the collocated Task.md file.

Does this skill support multi-turn agent evaluation?

Yes, it includes a multi-turn simulation reference with a runner, model user, and Harbor adapter example. It requires proving the first input matches instruction.md, later turns follow the declared user policy, and one approved session is reused.

Why do agent benchmark pass rates mislead?

Pass rates alone cannot prove task quality because weak models can pass through leakage and strong models can fail from broken environments. Calibration requires reading complete trajectories and classifying each failure as capability, harness, environment, verifier, leakage, or infrastructure.

When should I not use model comparison for calibration?

Model comparison is optional and only useful when it answers a named uncertainty, such as an unclear instruction or a weak verifier. One carefully inspected target-model run can be sufficient when deterministic checks pass.