debug

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve problems with the containerized agent execution system, including issues with logs, environment variables, mounts, and authentication.

Core Features & Use Cases

  • Log Analysis: Pinpoint errors by examining host and container logs.
  • Configuration Verification: Check environment variable passing and volume mounts.
  • Troubleshooting Common Errors: Addresses issues like authentication failures and permission errors.
  • Use Case: If your agent is failing to start or encountering "permission denied" errors, use this Skill to systematically check the container's configuration, logs, and mount points to identify the root cause.

Quick Start

Run the diagnostic script to check for common NanoClaw container setup issues.

Frequently Asked Questions about debug

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

FAQPage Schema
Why does my containerized agent encounter permission denied errors?

Permission denied errors in a containerized agent often stem from root user restrictions or incorrect file system permissions. Verify your Docker mount configurations and adjust environment variables to resolve access issues.

How do I troubleshoot container agent authentication failures?

To troubleshoot container agent authentication failures, systematically analyze host and container logs. Check your environment variable passing to ensure credentials are correctly mounted and accessible within the Node.js environment.

How do I verify environment variables passed to a Docker container?

Verify environment variables passed to a Docker container by checking your mount configurations and execution system logs. This helps pinpoint whether missing variables cause session persistence errors or authentication issues.

What is the best way to analyze Docker logs for agent startup failures?

The best way to analyze Docker logs for agent startup failures is to examine both host and container logs. This pinpoints specific errors like authentication failures or session persistence issues within your execution environment.

Does this troubleshooting approach work for Node.js containerized environments?

Yes, this troubleshooting approach works specifically for Node.js containerized environments. It diagnoses issues by analyzing logs, verifying environment variable mounting, and checking file system permissions within your Docker setup.