troubleshoot

Analyze JSONL debug logs to explain unexpected chat agent behavior.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/petarkabashki/vs-copilot-demistified --skill troubleshoot-petarkabashki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/petarkabashki/vs-copilot-demistified/tree/main/assets/prompts/skills/troubleshoot
Command: npx skills add https://github.com/petarkabashki/vs-copilot-demistified --skill troubleshoot-petarkabashki

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you understand why an AI agent behaved unexpectedly, such as slow responses, incorrect tool usage, or failure to load instructions.

Core Features & Use Cases

  • Root Cause Analysis: Investigates issues by analyzing direct debug logs.
  • Evidence-Based Conclusions: Bases explanations on log data, avoiding guesswork.
  • Use Case: If an agent failed to load a specific skill, this Skill can analyze the discovery logs to pinpoint the exact reason, like a name mismatch or a configuration error.

Quick Start

Investigate why the last request was slow by analyzing the session debug logs.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I diagnose unexpected AI agent behavior like slow responses or incorrect tool usage?

Diagnose unexpected AI agent behavior by analyzing direct debug logs in JSONL files. This approach investigates issues like slow responses or incorrect tool usage by deriving root causes from evidence within discovery, llm_request, and agent_response event logs.

Why does my chat agent fail to load a specific instruction or skill?

Chat agent instruction or skill loading failures are diagnosed by analyzing direct debug logs. Investigating discovery event logs pinpoints exact reasons for these failures, such as name mismatches or configuration errors, based on concrete log evidence.

How do I find the root cause of request latency in my AI agent?

Find the root cause of AI agent request latency by investigating direct debug logs. Analyzing JSONL log files for discovery, tool_call, llm_request, and subagent event types reveals the exact bottlenecks causing slow responses.

Can I investigate skipped instructions in my chat agent without guessing?

You can investigate skipped chat agent instructions without guessing by deriving conclusions from direct debug logs. Analyzing JSONL log evidence focuses on specific event types like user_message and agent_response to explain the skipped behavior accurately.

What is the best way to analyze debug logs for subagent invocation issues?

The best way to analyze debug logs for subagent invocation issues is to investigate direct JSONL log files. By examining subagent event types within the logs, you can derive evidence-based conclusions to explain unexpected tool or subagent behavior.

What types of events should I look for in JSONL debug logs to troubleshoot AI agent issues?

To troubleshoot AI agent issues in JSONL debug logs, look for discovery, tool_call, llm_request, agent_response, user_message, and subagent event types. Analyzing these specific log entries helps derive evidence-based conclusions about unexpected behavior.