read-inspect-eval

Extract samples, messages, events, and metrics from Inspect AI .eval logs.

1|Updated May 12, 2018
One-click install
npx skills add https://github.com/tbroadley/dotfiles --skill read-inspect-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-inspect-eval
Source: https://github.com/tbroadley/dotfiles/tree/main/claude/skills/read-inspect-eval
Command: npx skills add https://github.com/tbroadley/dotfiles --skill read-inspect-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires inspect-ai.

What problem does it solve?

This Skill helps data analysts and ML engineers quickly interpret Inspect AI evaluation logs by extracting samples, messages, events, and performance metrics from .eval files, reducing manual log-parsing effort.

Core Features & Use Cases

  • Log exploration: List and inspect evaluation runs, samples, and messages to diagnose model behavior.
  • Metrics extraction: Retrieve scores, task details, and results for reporting and comparison.
  • Dataframe-ready: Convert eval data into structured dataframes for analysis and visualization.

Quick Start

Install the Inspect AI package and load an evaluation file with the inspect_ai.log module, then iterate over logs and samples to compute key metrics.

Frequently Asked Questions about read-inspect-eval

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

FAQPage Schema
How do I extract samples and metrics from Inspect AI evaluation logs?

To extract samples and metrics from Inspect AI evaluation logs, load .eval files using the inspect_ai.log module, iterate over samples and messages, and compute summary statistics or export results to dataframes.

What is the best way to analyze .eval files for per-sample model behavior?

Analyzing .eval files for per-sample model behavior requires iterating through evaluation runs, samples, and messages to inspect events and scores, which helps diagnose model responses and reduces manual log-parsing effort.

Do I need the inspect-ai package to read .eval files and generate dataframes?

Yes, reading .eval files and generating dataframes requires the inspect-ai package and the inspect_ai.log analysis interfaces to load logs, iterate samples, and export structured results.

Can I retrieve scores and task details from multiple evaluation runs for comparison?

Yes, you can retrieve scores and task details from multiple evaluation runs for comparison by applying the analysis across tasks and models to enable per-sample inspection and summary statistics.

How do I convert Inspect AI evaluation data into a structured dataframe?

To convert Inspect AI evaluation data into a structured dataframe, load .eval files via the inspect_ai.log module, iterate over samples and events, and export the extracted metrics into a dataframe-ready format for analysis.