debug

Diagnose container agent failures with structured debugging steps and log locations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps diagnose and fix issues impacting the NanoClaw container execution system, including logs, environment variables, mounts, and session handling.

Core Features & Use Cases

  • Debug logging reveals full mount configurations, container command arguments, and real-time container stderr.
  • Guides troubleshooting for authentication, environment variables, and session resumption.
  • Provides common issue checklists and step-by-step fixes.

Quick Start

Run the container with LOG_LEVEL=debug to surface full mount configurations, container command arguments, and real-time container stderr.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug container authentication issues and noisy logs?

To debug container authentication issues and noisy logs, run the container with LOG_LEVEL=debug to surface full mount configurations, command arguments, and real-time stderr output. This exposes detailed session and environment variable data for troubleshooting.

What is the best way to troubleshoot container environment variables and mount configurations?

Troubleshooting container environment variables and mount configurations requires enabling debug logging to reveal the full mount setup and container command arguments. This process surfaces real-time stderr and provides checklists for common configuration issues.

Why does my container agent fail during session resumption?

Container agent session resumption failures often stem from misconfigured environment variables or mount issues. Structured debugging steps surface log locations and provide remediation strategies to identify and fix the specific session handling errors.

How do I enable debug logging to understand container configuration and stderr?

You enable debug logging to understand container configuration by setting the environment variable LOG_LEVEL=debug. This surfaces full mount configurations, real-time container stderr, and command arguments needed to diagnose execution system issues.

Can I fix container agent failures without external dependencies?

Yes, you can fix container agent failures without external dependencies by following structured debugging steps. The process uses built-in log locations, debug logging, and common issue checklists to provide step-by-step remediation strategies.

What should I do when container configuration troubleshooting is not working?

When container configuration troubleshooting is not working, enforce structured debugging steps to surface hidden log locations. Enable debug logging to inspect real-time stderr, validate environment variables, and review common issue checklists for remediation strategies.