skills.rest
nutterbrand
nutterbrandCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

debug

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

Updated Feb 22, 2026
Search Tags:#debugging#authentication#troubleshooting#logs#docker#containers
One-click install
npx skills add https://github.com/nutterbrand/nanoclaw --skill debug-nutterbrand
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/nutterbrand/nanoclaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/nutterbrand/nanoclaw --skill debug-nutterbrand

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 environment.

Core Features & Use Cases

  • Log Analysis: Pinpoints the location and content of host and container logs for debugging.
  • Environment & Mount Verification: Helps confirm that environment variables and file mounts are correctly configured for the container.
  • Common Issue Resolution: Provides specific fixes for frequent problems like missing authentication or permission errors.
  • Use Case: If your agent fails to start and you see an error about missing authentication, use this Skill to check your .env file and container mounts.

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 authentication failures in a Docker container agent?▼

Troubleshoot container agent authentication failures by verifying environment variables and checking that your `.env` file is correctly mounted to the container. Analyze container logs to pinpoint missing credentials.

Why does my containerized agent fail to start with a permission error?▼

Containerized agents fail to start with permission errors when file mounts are incorrectly configured or lack proper access rights. Diagnose the exact issue by analyzing host and container logs to identify restricted paths.

What is the best way to analyze Docker logs for agent session persistence issues?▼

The best way to analyze Docker logs for agent session persistence issues is to locate and read both host and container logs. Verify SDK options to ensure session states are maintained across container restarts.

How do I verify environment variables and file mounts for a containerized agent?▼

Verify environment variables and file mounts for a containerized agent by running a diagnostic script to check common setup issues. Manually test the container configuration to ensure all required variables are loaded.

Can I manually test a Docker container to resolve agent startup failures?▼

You can manually test a Docker container to resolve agent startup failures by executing the container environment directly. This isolates whether the issue stems from application code or container configuration mismatches.

Related Skills

Explore More Software Engineering Skills→
reasonlayerreasonlayer

debug

Diagnose container agent issues in Claude-based workflows.

Official
Intermediate
DingyangLyuDingyangLyu
85

debug

Diagnoses Docker/AJSHA client container and agent-run failures including authentication, mounts, permissions, sessions, and MCP/SDK errors.

Community
Advanced
mgkyawzayyamgkyawzayya
1

debug

Diagnose container agent issues by inspecting logs, mounts, and environment variables.

Community
Intermediate
zhaosj0315zhaosj0315

debug

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

Community
Advanced