skills.rest
arnaudjnn
arnaudjnnCOMMUNITY
Explore all skills by this author →
𝕏@arnaudjnnGitHub

debug

Diagnoses containerized AI agent issues via logs, environment variables, volumes, and scripts.

1|21|Updated Feb 26, 2026
Search Tags:#debugging#troubleshooting#logs#agent#docker#container
One-click install
npx skills add https://github.com/arnaudjnn/nanoclaw-railway --skill debug-arnaudjnn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/arnaudjnn/nanoclaw-railway/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/arnaudjnn/nanoclaw-railway --skill debug-arnaudjnn

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 startup failures, authentication problems, and understanding the container's internal workings.

Core Features & Use Cases

  • Log Analysis: Pinpoints the exact locations of host and container logs for detailed error inspection.
  • Environment & Mount Verification: Guides users on how to check environment variable propagation and volume mount configurations within the container.
  • Common Issue Resolution: Provides step-by-step fixes for frequent problems like authentication errors, permission issues, and session resumption failures.
  • Use Case: If your agent fails to start with a cryptic error message, use this Skill to navigate to the correct log file, inspect the container's environment variables, and identify if a missing API key or incorrect mount path is the cause.

Quick Start

Run the diagnostic script provided in the skill's documentation to check for common setup issues.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot a containerized agent that fails to start with a cryptic error?▼

To troubleshoot containerized agent startup failures, you need to locate the exact host and container log files for detailed error inspection. This skill helps pinpoint those log locations to identify if missing API keys or incorrect mount paths cause the issue.

Why does my Docker container lose session persistence and fail to resume?▼

Docker container session persistence failures often occur due to incorrect volume mount configurations. This skill guides you through verifying volume mounts and environment variable propagation within the isolated Linux container to resolve session resumption issues.

How do I check if environment variables are propagating correctly to my isolated Linux container?▼

Checking environment variable propagation involves inspecting the container's internal environment setup for missing values. This skill provides diagnostic scripts to verify environment variables, helping you identify and fix missing API keys or incorrect configuration paths.

What is the best way to resolve authentication failures in containerized AI agents?▼

Resolving authentication failures in containerized AI agents requires verifying that necessary API keys are correctly mounted and propagated. This skill provides step-by-step fixes for common permission issues and authentication errors within your container environment.

Where are the log files located for debugging a Docker container agent?▼

Log files for debugging a Docker container agent are split between host and container specific directories. This skill pinpoints the exact locations of both host and container logs, enabling detailed inspection of agent execution errors.

Related Skills

Explore More Software Engineering Skills→
b9b4ymiNb9b4ymiN

convert-to-docker

Migrate NanoClaw from Apple Container to Docker for macOS and Linux.

Community
Advanced
cribclawcribclaw

debug

Diagnose containerized AI agent issues by analyzing logs and verifying configurations.

Community
Advanced
theowenyoungtheowenyoung

debug

Inspect logs, env configuration, mounts, and session handling to debug NanoClaw container agent issues.

Community
Intermediate
zhaosj0315zhaosj0315

debug

Diagnose and fix containerized NanoClaw agent issues via logs and environment checks.

Community
Advanced