troubleshoot

Parse and correlate JSONL debug logs to identify root causes of chat agent issues.

Updated Jul 12, 2026
One-click install
npx skills add https://github.com/mdjubaerhossensabbir/Hiar_Jubba --skill troubleshoot-mdjubaerhossensabbir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/mdjubaerhossensabbir/Hiar_Jubba/tree/main/troubleshoot
Command: npx skills add https://github.com/mdjubaerhossensabbir/Hiar_Jubba --skill troubleshoot-mdjubaerhossensabbir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves confusion regarding unexpected chat agent behavior by providing a structured, evidence-based method to analyze internal debug logs.

Core Features & Use Cases

  • Root Cause Analysis: Investigates latency, tool failures, and instruction loading issues by correlating events in session logs.
  • Behavioral Verification: Confirms why specific tools, subagents, or system prompts were triggered during a conversation.
  • Use Case: When a user asks why a request was slow or why a specific tool was skipped, this skill guides the analysis of the main.jsonl file to pinpoint the exact event and duration.

Quick Start

Use the troubleshoot skill to analyze the session logs in the current directory to identify why the last request failed.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I debug unexpected chat agent behavior using JSONL logs?

Debug unexpected chat agent behavior by parsing and correlating JSONL debug logs. Systematically filter event types and span hierarchies to identify root causes from session metadata.

What is the best way to troubleshoot tool invocation failures in a Copilot session?

Troubleshoot tool invocation failures in a Copilot session by analyzing the main.jsonl file. Correlate events and filter span hierarchies to pinpoint the exact event causing the failure.

How do I diagnose latency issues from debug logs?

Diagnose latency issues from debug logs by correlating event durations within the session logs. This process identifies the exact events and spans responsible for slow request processing.

Why does my Copilot skip specific tools during a conversation?

Copilot might skip specific tools due to instruction loading issues or behavioral triggers. Verify why tools were skipped by guiding the analysis of session logs to confirm the exact trigger.

What do I need to analyze session logs for chat agent troubleshooting?

To analyze session logs for chat agent troubleshooting, you need the main.jsonl debug log file available in the current directory. The skill systematically filters event types to find root causes.