debug

Diagnose containerized AI system issues via logs, env vars, mounts, and SDK options.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps troubleshoot and resolve issues related to the containerized AI agent system, ensuring smooth operation and understanding its internal workings.

Core Features & Use Cases

  • Container Debugging: Diagnose problems with container failures, authentication, and environment configurations.
  • Log Analysis: Pinpoint issues by examining host and container logs.
  • Configuration Verification: Check mount points, environment variables, and permissions within the container.
  • Use Case: If your AI agent is failing to start or respond, use this Skill to check its logs, verify API keys, and ensure the necessary files are correctly mounted into the container.

Quick Start

Run the diagnostic script to check for common NanoClaw 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 debug a containerized AI agent that fails to start?

To debug a containerized AI agent that fails to start, you can analyze host and container logs, verify environment variables like API keys, and check volume mount points to pinpoint configuration or authentication issues.

Why does my container agent experience authentication failures during startup?

Authentication failures in a container agent often occur due to missing or incorrect environment variables. You can resolve this by verifying API keys and checking environment configurations within the container setup.

How do I check volume mounts and permissions in a container agent environment?

You can check volume mounts and permissions by verifying mount points and ensuring necessary files are correctly mounted into the container, addressing common problems like root user restrictions that block agent operations.

What is the best way to analyze container logs for session resumption errors?

Analyzing container logs for session resumption errors involves examining both host and container logs to identify runtime issues, supplemented by manual testing procedures and SDK option references for effective troubleshooting.

Can I use manual testing procedures to troubleshoot container agent issues?

Yes, you can use manual testing procedures to troubleshoot container agent issues. The skill provides diagnostic procedures and SDK option references to test and resolve common problems like root user restrictions and session errors.

What are common limitations when troubleshooting a containerized AI agent system?

Limitations when troubleshooting a containerized AI agent system include encountering root user restrictions within the container and session resumption errors, which require verifying specific environment variables and mount point configurations.