debug

Diagnose containerized agent issues by analyzing logs and verifying environment variables.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues with containerized agents, including startup failures, authentication problems, and understanding the container system's architecture.

Core Features & Use Cases

  • Log Analysis: Pinpoints the location and content of various logs (main app, container runs, sessions).
  • Environment & Mount Verification: Guides users on checking environment variable propagation and volume mount configurations within the container.
  • Common Issue Resolution: Provides step-by-step fixes for frequent errors like authentication failures, permission issues, and session resumption problems.

Quick Start

Run the diagnostic script to check 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 debug authentication failures in a containerized agent?

To debug authentication failures in a containerized agent, analyze the container run logs to identify credential errors, verify environment variable propagation for secrets, and check permission settings within the isolated Linux container.

Why does my Claude Agent SDK session fail to resume in an isolated Linux container?

Session resumption fails in an isolated Linux container when volume mount configurations are incorrect or session persistence logs are inaccessible. Verify mount configurations and check environment variables to ensure session state is properly saved.

Where can I find logs for troubleshooting container agent startup failures?

Logs for troubleshooting container agent startup failures are located in specific main app, container run, and session log files. Pinpointing the exact location and content of these logs helps diagnose environment and permission issues.

How do I verify environment variables and volume mounts for AI agents in containers?

Verify environment variables and volume mounts by running a diagnostic script to check container setup. This script guides users on environment variable propagation and validates volume mount configurations within the isolated container runtime.

What causes permission errors when running agents in isolated Linux containers?

Permission errors in isolated Linux containers occur when volume mount configurations restrict access or environment variables lack proper privileges. Debugging involves analyzing container runtime behavior and verifying mount configurations step by step.