session-investigator

What problem does it solve?

This Skill helps engineers diagnose fast-agent session issues by analyzing session.json and history_*.json files to identify failures, timing gaps, and tool-call correlations.

Core Features & Use Cases

• Analyze session.json and history_<agent>.json to detect unexpected session ends and timing anomalies.
• Correlate assistant tool_calls with user tool_results and timing channels to diagnose failed loops and misalignments.
• Provide guidance for diagnosing common failure patterns and for trimming or validating history data.

Quick Start

Inspect a problematic session by reviewing session.json and history_*.json in the session directory and using the provided jq queries to identify pending tool calls, stop reasons, and timing anomalies.