session-investigator

Diagnose fast-agent session failures by analyzing session.json and history JSON files.

3.9k|432|Updated Jan 18, 2025
One-click install
npx skills add https://github.com/evalstate/fast-agent --skill session-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-investigator
Source: https://github.com/evalstate/fast-agent/tree/main/examples/hf-toad-cards/skills/session-investigator
Command: npx skills add https://github.com/evalstate/fast-agent --skill session-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about session-investigator

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

FAQPage Schema
How do I debug a fast-agent session that ended unexpectedly?

Diagnose unexpected session endings by reading session.json metadata and history_*.json files to identify stop reasons, pending tool calls, and timing anomalies that reveal the specific failure patterns.

How do I correlate sub-agent traces with main session history logs?

Correlate sub-agent traces with main session history logs by examining history_*.json files to align assistant tool_calls with user tool_results and timing channels, diagnosing conversation flow misalignments and loops.

What is the best way to identify tool loops in fast-agent history JSON files?

Identify tool loops in fast-agent history JSON files by using jq queries to inspect history_*.json structures, matching assistant tool_calls against user tool_results, and analyzing timing channels for repeated patterns.

Can I use jq queries to analyze timing anomalies in session.json files?

Yes, you can use jq queries to analyze timing anomalies in session.json and history_*.json files, extracting stop reasons, pending tool calls, and timing channel data to detect conversation flow gaps.

When do I need to inspect history_*.json files to diagnose fast-agent failures?

Inspect history_*.json files to diagnose fast-agent failures when sessions end unexpectedly, when tool loops occur, or when correlating sub-agent traces with main sessions to analyze conversation flow and timing anomalies.

Why does my fast-agent session keep looping tool calls without completing?

Fast-agent sessions loop tool calls without completing due to misalignments between assistant tool_calls and user tool_results; examining history_*.json timing channels and stop reasons diagnoses these failed loop patterns.