Agent Debugging

Diagnose and resolve debugging issues across agentic frameworks.

3|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/MattMagg/agentic-plugins --skill agent-debugging-mattmagg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Agent Debugging
Source: https://github.com/MattMagg/agentic-plugins/tree/main/plugins/agentic-builder/skills/debugging
Command: npx skills add https://github.com/MattMagg/agentic-plugins --skill agent-debugging-mattmagg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging across agentic frameworks to identify, reproduce, isolate, and fix issues using a structured, repeatable workflow and RAG-assisted queries.

Core Features & Use Cases

  • Diagnostic categories for common failure modes: IMPORT, TOOL, AUTH, CONFIG, RUNTIME, MULTI_AGENT, STREAMING.
  • Step-by-step debugging process: Reproduce, Isolate, Categorize, Diagnose, Fix & Verify.
  • RAG-powered guidance and framework-specific checks to accelerate triage and resolution.

Quick Start

Enable verbose tracing for your framework, reproduce the issue, and follow the step-by-step debugging process to isolate and fix it.

Frequently Asked Questions about Agent Debugging

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

FAQPage Schema
How do I debug multi-agent routing issues across different agent frameworks?▼

Debug multi-agent routing using a structured workflow: reproduce, isolate, categorize, diagnose, fix, and verify. RAG-powered guidance and framework-specific checks accelerate triage and resolution of MULTI_AGENT failures across diverse agent frameworks.

What is the best way to troubleshoot runtime anomalies in agentic frameworks?▼

Troubleshoot runtime anomalies by enabling verbose tracing and following a step-by-step debugging process. The workflow categorizes RUNTIME failures and provides RAG queries to systematically isolate and fix the root cause.

How do I systematically diagnose authentication and configuration errors in agent deployments?▼

Diagnose authentication and configuration errors by categorizing them into AUTH or CONFIG failure modes. The diagnostic workflow uses RAG-assisted queries and framework-specific checks to isolate the issue and verify the applied fix.

Does this troubleshooting workflow handle tool import failures and streaming issues?▼

Yes, the troubleshooting workflow handles tool import failures and streaming issues. It categorizes these as IMPORT, TOOL, and STREAMING failure modes, applying RAG-powered guidance to systematically resolve them.

What are the limitations of using a structured debugging workflow for multi-framework deployments?▼

The workflow requires strict adherence to its six-step process: reproduce, isolate, categorize, diagnose, fix, and verify. You must enable verbose tracing first, as skipping reproduction limits accurate RAG-assisted diagnosis of runtime anomalies.