debug

Diagnose container agent issues across logs, environment variables, and mounts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to understand how the container system works. Covers logs, environment variables, mounts, and common issues.

Core Features & Use Cases

  • Guided debugging workflow: Provides structured steps to reproduce and diagnose container problems across logs, env, mounts, and sessions.
  • Issue resolution playbook: Curated fixes for common errors like authentication failures, permission issues, and session resumption.
  • Diagnostic tooling integration: Includes quick diagnostic script and references for container setup and IPC workflows.

Quick Start

Follow the diagnostic guide to reproduce the failure and apply the fixes specified in the common issues section.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug a container that keeps failing on startup?

To debug a failing container, you need a structured diagnostic protocol covering logs, environment variables, and mounts. Following guided steps helps reproduce the failure, identify root causes like permission issues, and apply targeted fixes.

Why does my container agent lose its session after restarting?

Container agents lose sessions when session persistence configurations are incorrect or mounts are not properly attached. Checking specific mount points and applying recommended session configurations can resolve common resumption issues.

What's the best way to check container environment variables during diagnostics?

The best way to check environment variables is by running a quick validation script as part of a structured diagnostic protocol. This verifies active configurations and helps pinpoint authentication failures or missing runtime parameters.

How do I troubleshoot container authentication problems and permission issues?

Troubleshooting container authentication and permission issues requires reviewing logs and validating environment variables. An issue resolution playbook provides curated fixes for these common errors to restore access quickly.

Do I need to configure mounts differently to fix common container agent issues?

Yes, incorrect mount configurations frequently cause container agent issues. Reviewing mount setups against recommended configurations and running a diagnostic script ensures mounts are properly attached and accessible.

What is a structured diagnostic protocol for container debugging?

A structured diagnostic protocol for container debugging is a guided workflow that systematically checks logs, environment variables, mounts, and sessions to reproduce failures. It provides actionable steps and a validation script to verify applied fixes.