debug

Diagnose containerized AI agent issues by analyzing logs, environment variables, and mounts.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/yordyi/megaclaw --skill debug-yordyi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/yordyi/megaclaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/yordyi/megaclaw --skill debug-yordyi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve problems with the containerized agent execution system, addressing issues like container failures, authentication errors, and understanding the system's internal workings.

Core Features & Use Cases

  • Container Debugging: Provides detailed information on logs, environment variables, and mount points within the container.
  • Issue Resolution: Offers specific fixes for common problems such as missing authentication, permission errors, and mount issues.
  • Use Case: If your AI agent is failing to start or respond, use this Skill to examine its container logs, verify API key configuration, and check how data is being mounted into the isolated environment.

Quick Start

Run the diagnostic script to check for common container setup issues.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot AI agent authentication failures in a Linux container?

To troubleshoot authentication failures in a Linux container, you need to analyze environment variables and container logs to verify API key configuration. This Skill inspects these isolated environment settings to identify missing or incorrectly configured authentication credentials.

Why does my containerized AI agent fail to start or respond?

Containerized agents often fail to start due to permission restrictions or incorrect volume mounts. This Skill resolves these issues by examining mount configurations and container logs to pinpoint the exact startup failure within the isolated environment.

How do I check volume mounts when debugging an isolated container agent?

To check volume mounts for an isolated container agent, you must inspect the mount configurations to ensure data is correctly mapped into the environment. This Skill analyzes these mount points to detect and resolve incorrect data mapping.

Can I use this Skill to debug the Claude Agent SDK execution in containers?

Yes, you can use this Skill to debug the Claude Agent SDK execution within isolated Linux containers. It facilitates the debugging process by providing detailed information on logs, environment variables, and internal system workings.

What is the best way to resolve permission restrictions in a containerized agent environment?

The best way to resolve permission restrictions in a containerized agent environment is to run diagnostic checks on the container setup. This Skill offers specific fixes for permission errors by analyzing the container's internal configuration and logs.