debug

Diagnose container agent issues by inspecting logs, mounts, and environment variables.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug container agent issues to keep the system running smoothly, diagnose failures, and understand behavior when containers misbehave.

Core Features & Use Cases

  • Log inspection: locate and interpret host and container logs to identify failures.
  • Environment & mounts validation: verify session and mount configurations to ensure proper operation.
  • Guided troubleshooting: provide step-by-step checks for common problems like authentication errors and MCP/server issues.

Quick Start

Run the debug skill against a failing run, review logs in logs/nanoclaw.log and container-specific logs under groups//logs/container-.log, verify environment variables and session mounts, and follow the guidelines in this document to identify and fix the issue.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug container agent issues and find out why my run failed?

To debug container agent issues, inspect host logs in logs/nanoclaw.log and container logs under groups/*/logs/container-*.log to identify failures, then verify environment variables and session mounts to restore reliable operation.

What is the best way to investigate container authentication errors and MCP server problems?

The best way to investigate container authentication errors and server problems is to follow guided troubleshooting steps that validate session persistence and inspect container-specific logs to pinpoint configuration failures.

How do I verify environment variable propagation across the host/container boundary?

To verify environment variable propagation across the host/container boundary, apply procedural validation checks to confirm variables are correctly passed and active within the container environment during troubleshooting.

How do I check if incorrect mount points are causing my container to misbehave?

To check if incorrect mount points cause container misbehavior, validate session and mount configurations to ensure proper operation, verifying that correct mount points are established across the host and container boundary.

When do I need to inspect container logs for diagnosing system failures?

You need to inspect container logs for diagnosing system failures when containers misbehave, enabling you to locate and interpret host and container logs to identify the root cause of the disruption.