error-analysis

Analyze LLM pipeline traces to identify and categorize failure modes.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/majidraza1228/eval-framework --skill error-analysis-majidraza1228
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-analysis
Source: https://github.com/majidraza1228/eval-framework/tree/main/skills/error-analysis
Command: npx skills add https://github.com/majidraza1228/eval-framework --skill error-analysis-majidraza1228

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically identify and categorize failure modes in an LLM pipeline by reading traces. Use when starting a new eval project, after significant pipeline changes (new features, model switches, prompt rewrites), when production metrics drop, or after incidents.

Core Features & Use Cases

  • Collect ~100 representative traces
  • Read each trace, judge pass/fail, and note what went wrong
  • Group similar failures into categories and label every trace accordingly
  • Compute failure rates to prioritize what to fix
  • Iterate to refine categories and ensure stable prioritization

Quick Start

Collect ~100 representative traces and start labeling failures to form an initial, actionable category taxonomy.

Frequently Asked Questions about error-analysis

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

FAQPage Schema
How do I identify and categorize failure modes in my LLM pipeline?

To identify failure modes in an LLM pipeline, collect ~100 representative traces, judge pass/fail for each, group similar failures into categories, and compute failure rates to prioritize remediation.

When should I perform trace analysis on my LLM pipeline?

Perform trace analysis when starting a new eval project, after significant pipeline changes like prompt rewrites or model switches, when production metrics drop, or after incidents occur.

What is the best way to prioritize which LLM failures to fix first?

The best way to prioritize LLM failures is to group similar trace failures into categories, compute their failure rates, and iterate to refine categories ensuring stable prioritization for remediation.

How many traces do I need to collect to analyze LLM failure modes?

You need to collect approximately 100 representative traces to start labeling pass/fail outcomes and form an initial, actionable category taxonomy for failure analysis.

Can I use this workflow to evaluate a new LLM eval project?

Yes, you can apply this repeatable workflow to new eval projects by collecting traces, reading them to label outcomes, clustering failures, and computing rates to guide remediation priorities.

Why do my LLM production metrics drop after a prompt rewrite?

Production metrics drop after prompt rewrites due to newly introduced failure modes, which you can systematically identify by reading traces, labeling outcomes, and categorizing the failures.