adk-debug

Inspect ADK agent sessions, event flows, and LLM interactions.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/rahulgupta2018/agent-skills --skill adk-debug-rahulgupta2018
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adk-debug
Source: https://github.com/rahulgupta2018/agent-skills/tree/main/skills/adk-debug
Command: npx skills add https://github.com/rahulgupta2018/agent-skills --skill adk-debug-rahulgupta2018

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves complex issues in ADK agent development by providing a structured framework for inspecting event flows, debugging LLM interactions, and testing agent logic in both CLI and web environments.

Core Features & Use Cases

  • Multi-Mode Debugging: Switch between adk web for visual session inspection and adk run for rapid, automated CLI testing.
  • Event & Trace Analysis: Deep-dive into session events, LLM request/response spans, and tool execution logs to identify bottlenecks or logic errors.
  • Use Case: When an agent fails to call a tool or produces unexpected output, use this skill to trace the specific LLM request and event flow to pinpoint the exact configuration or code failure.

Quick Start

Use the adk-debug skill to run the agent in verbose mode and output the event stream to a log file for inspection.

Frequently Asked Questions about adk-debug

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

FAQPage Schema
How do I trace event flow and LLM interactions to debug an ADK agent?

To debug an ADK agent, you can inspect session events and trace LLM request/response spans to pinpoint logic errors. The skill provides standardized logging to help identify bottlenecks or failures in tool execution and configuration.

Why does my ADK agent fail to call a tool or produce unexpected output?

ADK agent tool execution failures often stem from configuration mismatches or code errors within the agent logic. You can trace the specific LLM request and event flow using diagnostic endpoints to perform root cause analysis on the failure.

Can I inspect ADK agent sessions in both CLI and web server environments?

Yes, you can inspect ADK agent sessions in both CLI and web server environments. The skill supports interactive CLI testing via adk run and visual session inspection via the adk web REST API for multi-turn agent scenarios.

What is the best way to test multi-turn agent scenarios in ADK?

The best way to test multi-turn ADK agent scenarios is by using the interactive CLI testing or REST API-based web server monitoring. These diagnostic modes allow you to monitor event flow and analyze interactions across multiple turns.

How do I capture verbose event streams to a log file for ADK agent troubleshooting?

To capture verbose event streams for ADK agent troubleshooting, run the agent in verbose mode and output the event stream to a log file. This facilitates structured root cause analysis of agent failures and tool execution errors.