eval-model-effectiveness

Analyze per-role model costs and observations to generate a markdown recommendations report.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/paulingham/.claude --skill eval-model-effectiveness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-model-effectiveness
Source: https://github.com/paulingham/.claude/tree/main/skills/eval-model-effectiveness
Command: npx skills add https://github.com/paulingham/.claude --skill eval-model-effectiveness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes pipeline observations and per-role costs to generate a data-driven recommendation report on model downgrades or upgrades, guiding humans to optimize resource use without automatically changing configurations.

Core Features & Use Cases

  • Analyze per-role effectiveness across pipeline observations and costs to identify downgrade or upgrade opportunities.
  • Produce a markdown report that summarizes recommendations and evidence for human-in-the-loop action.
  • Use in scenarios where teams want to optimize model-tier choices (e.g., Opus, Sonnet, Haiku) based on success-rate and cost metrics.

Quick Start

Run the analyze.py script for the current project.

Frequently Asked Questions about eval-model-effectiveness

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

FAQPage Schema
How do I analyze pipeline observations and per-role costs to decide on model upgrades or downgrades?

To analyze pipeline observations and per-role costs for model upgrades or downgrades, run the analyze.py script. It joins observations with cost data to evaluate success rates and cost per success, generating a markdown recommendations report.

What data do I need to evaluate agent model effectiveness in my pipeline?

Evaluating agent model effectiveness requires projects with per-role model usage and cost data, alongside pipeline observations. The Skill joins these costs with observations to measure success rates and calculate the cost per success.

Does this Skill automatically change my agent configurations to optimize costs?

No, this Skill does not automatically change agent configurations. It produces a markdown model-recommendations report with downgrade and upgrade guidance, leaving final changes to human operators.

How do I generate a model recommendations report for human-in-the-loop review?

To generate a model recommendations report for human-in-the-loop review, execute the analyze.py script for your current project. It outputs a markdown file in your learning directory summarizing effectiveness and cost metrics.

When should I use an automated report to tune agent models instead of manual analysis?

Use an automated report to tune agent models when teams want to optimize model-tier choices like Opus, Sonnet, or Haiku based on success-rate and cost metrics. It provides data-driven downgrade and upgrade guidance for resource optimization.