debugging-agents

Diagnose Agent2 agent issues with error checks, container health, and schema validation.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/duozokker/live-interview-prep-agent2-mvp --skill debugging-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-agents
Source: https://github.com/duozokker/live-interview-prep-agent2-mvp/tree/main/agent-two/.gemini/skills/debugging-agents
Command: npx skills add https://github.com/duozokker/live-interview-prep-agent2-mvp --skill debugging-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docker, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps diagnose and address common issues with Agent2 agents, ensuring smooth operation and efficient debugging.

Core Features & Use Cases

  • Error Diagnostics: Identify the root cause of errors like 500s, mock data, or incorrect behavior in Agent2 agents.
  • Container Health Checks: Verify the health of Docker containers running Agent2 agents.
  • Schema Validation: Validate Agent2 output against expected schemas.
  • Use Case: When your Agent2 agent is returning unexpected results or not starting, use this Skill to systematically diagnose and resolve the issue.

Quick Start

To start debugging your Agent2 agent, use the debugging-agents skill with the command: start-agent-debugging.

Frequently Asked Questions about debugging-agents

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

FAQPage Schema
How do I diagnose Agent2 agent issues causing 500 errors or unexpected mock data?

To diagnose Agent2 agent issues, use systematic error diagnostics to identify root causes of 500 errors, unexpected mock data, and incorrect behavior. The Skill checks container health, validates output schemas, and isolates root causes for resolution.

What is the best way to verify Docker container health for Agent2 agents?

The best way to verify Docker container health for Agent2 agents is running dedicated container health checks. This process evaluates container status to ensure agents operate correctly and helps detect environmental issues causing unexpected agent failures.

Can I validate Agent2 output against expected schemas using Python?

Yes, you can validate Agent2 output against expected schemas using a Python environment. Schema validation checks agent responses for structural correctness, ensuring outputs match defined formats and identifying discrepancies causing incorrect application behavior.

Do I need Docker and Python installed to debug Agent2 agents?

Yes, you need both Docker and Python installed to debug Agent2 agents. A Python environment with Docker is required to run agent operations, execute diagnostic scripts, and perform container health checks during the troubleshooting process.

Why does my Agent2 agent return incorrect behavior or fail to start?

Your Agent2 agent may return incorrect behavior or fail to start due to container health issues, schema mismatches, or internal errors. Systematic agent diagnostics can identify root causes by checking container status, validating schemas, and analyzing error logs.