compare-trajectories

Compare trajectory exports to classify per-task behavioral gaps between model runs.

10|5|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/understudylabs/understudy-agent-tools --skill compare-trajectories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compare-trajectories
Source: https://github.com/understudylabs/understudy-agent-tools/tree/main/skills/compare-trajectories
Command: npx skills add https://github.com/understudylabs/understudy-agent-tools --skill compare-trajectories

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Identify per-task behavioral differences between two trajectory exports, enabling you to understand not just which run scores higher, but how and why their trajectories diverge on the same tasks.

Core Features & Use Cases

  • Align and compare trajectory exports to reveal per-task behavioral gaps and their classifications (persistence/recovery, knowledge, format/parsing).
  • Generate an outcome-delta matrix and produce warm-start candidates by highlighting clean, actionable differences for distillation or improvement.
  • Use alongside scalar model-sweep analyses to diagnose whether differences are due to strategy, retrieval, or decoding.

Quick Start

Diff two trajectory exports to identify per-task divergence and categorize the reachable gaps.

Frequently Asked Questions about compare-trajectories

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

FAQPage Schema
How do I compare two model runs to find behavioral differences?

To compare model runs, you need to align two trajectory exports sharing the same task set and harness. Trajectory diffing identifies per-task behavioral gaps and classifies divergence reasons like persistence, knowledge, or format parsing.

Why does my model trajectory diverge on the same tasks?

Trajectories diverge due to differences in strategy, retrieval, or decoding during model runs. Comparing aligned exports categorizes these behavioral gaps into persistence, recovery, knowledge, or format and parsing issues.

What is trajectory diffing for debugging AI systems?

Trajectory diffing is the process of comparing two model run exports to pinpoint how and why their execution paths diverge on the same tasks. It produces an outcome-delta matrix and gap classifications for debugging.

Do I need aligned task IDs to compare trajectory exports?

Yes, trajectory comparison requires aligned run exports with a defined task-id space. Both model runs must share the same task set, harness, and tool-access mode to accurately identify per-task behavioral differences.

Can I generate warm-start candidates from trajectory differences?

Yes, comparing trajectory exports highlights clean and actionable differences between model runs. These identified gaps are used to produce warm-start candidates for distillation or targeted model improvement.

What are the limitations of trajectory alignment for model comparison?

Trajectory alignment only works when two model runs share the exact same task set, harness, and tool-access mode. It requires a trajectory-diff workflow and cannot compare runs with mismatched task-id spaces or differing tool access.