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.