debug

Diagnose containerized AI agent issues via log analysis and configuration verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues related to containerized agent execution, including authentication, environment variables, mounts, and general container failures.

Core Features & Use Cases

  • Log Analysis: Pinpoint errors by examining host and container logs.
  • Configuration Verification: Check environment variables, mount points, and permissions within the container.
  • Troubleshooting Common Errors: Provides solutions for issues like authentication failures, permission errors, and session resumption problems.
  • Use Case: If your agent is failing to start or encountering unexpected errors, use this Skill to systematically check its configuration and logs to identify the root cause.

Quick Start

Use the debug skill to check the container logs for the 'test' group.

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 authentication failures and permission errors?

Troubleshooting container agent issues involves examining host and container logs to pinpoint errors, verifying environment variables and mount points, and checking session persistence within isolated Linux containers.

How do I troubleshoot environment variable propagation in Docker containers?

Troubleshoot environment variable propagation in Docker containers by verifying configuration settings, checking container image integrity, and ensuring variables are correctly passed to the isolated Linux container environment.

Why does my container agent fail to resume sessions?

Container agents fail to resume sessions due to incorrect volume mounting or session persistence configurations within the isolated Linux container, which you can diagnose through log analysis and configuration verification.

How do I check container logs to diagnose agent startup failures?

Check container logs for agent startup failures by examining host and container logs, verifying IPC communication mechanisms, and inspecting container image integrity to identify the root cause of unexpected errors.

Does this approach work for resolving volume mounting issues in isolated Linux containers?

Yes, this approach works for resolving volume mounting issues in isolated Linux containers by systematically verifying mount points and permissions alongside checking container image integrity and IPC communication.

What are common limitations when debugging containerized AI agents?

Troubleshooting container agent issues involves examining host and container logs to pinpoint errors, verifying environment variables and mount points, and checking session persistence within isolated Linux containers.