skills.rest
theowenyoung
theowenyoungCOMMUNITY
Explore all skills by this author →
Website𝕏@TheOwenYoungGitHub

debug

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

Updated Mar 12, 2026
Search Tags:#debugging#logs#environment#container#sessions#nanoclaw#mounts
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill debug-theowenyoung
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill debug-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging and troubleshooting containerized agent execution issues in NanoClaw, including logs, environment configurations, mounts, authentication problems, and common failures.

Core Features & Use Cases

  • Unified debugging guide for containerized agent runs, covering logs, env vars, mounts, and IPC.
  • Step-by-step checks for authentication, session persistence, and container spawning problems.
  • Real-world use cases include diagnosing failed agent startup, broken data mounts, and session resumption issues.

Quick Start

Run the NanoClaw container in debug mode and follow the guided steps to inspect logs, environment, mounts, and sessions.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug container agent authentication errors in NanoClaw deployments?▼

Debug authentication errors by verifying permissions, checking environment configurations, and ensuring correct HOME paths for container agents. This process inspects session persistence and MCP-server initialization to resolve access failures securely.

Why does my container agent fail to spawn or resume sessions?▼

Container agents fail to spawn due to incorrect environment variables, broken mounts, or improper session handling. Inspect logs and enforce checks for session persistence and permissions to identify and resolve the startup failure.

How do I diagnose container-to-host IPC or file-mount failures?▼

Diagnose container-to-host IPC and file-mount failures by inspecting mount configurations and verifying environment variables. Checking permissions and correct HOME paths ensures reliable agent operation across deployments.

What is the best way to inspect container agent logs and environment configurations?▼

Inspect container agent logs and environment configurations by running the container in debug mode. This provides a guided step-by-step process to review env vars, mounts, and session data for troubleshooting.

Can I use this debugging approach for broken data mounts in containerized agents?▼

Yes, you can troubleshoot broken data mounts by applying checks for permissions and correct mount configurations. Inspecting logs and environment variables helps identify and fix file-mount failures securely.

When should I check MCP-server initialization to resolve container agent issues?▼

Check MCP-server initialization when experiencing container spawn problems or authentication errors. Enforcing initialization checks ensures secure, reliable agent operation and resolves common deployment failures.

Related Skills

Explore More Software Engineering Skills→
Arno37Arno37

debug

Diagnose container agent issues across local and CI deployments.

Community
Intermediate
thmtzthmtz
5

manage-mounts

Configure and control host directory access for NanoClaw agent containers.

Community
Intermediate
githubgithub
123

awf-debug-tools

Parse AWF logs and container health to diagnose firewall problems.

Official
Intermediate
LIMITLESS-LONGEVITYLIMITLESS-LONGEVITY

debug

Diagnose NanoClaw container failures involving mounts, environment variables, and MCP initialization.

Official
Advanced