debug

Diagnose and fix NanoClaw container agent execution, logs, and environment issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix issues affecting the NanoClaw container agent execution, logs, and environment.

Core Features & Use Cases

  • Debug logging setup and verification
  • Identifying and resolving mounting, permission, and session-resumption issues
  • Guided manual testing of container workflows and IPC communication
  • Quick-start diagnostic workflow to surface actionable errors

Quick Start

Run the diagnostic workflow to quickly surface configuration or runtime issues with the NanoClaw container.

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 startup failures and check logs?

To debug container agent startup failures, run the quick-start diagnostic workflow to surface actionable errors, verify logging setup, and inspect documented log locations for misconfigured mounts or runtime issues.

Why does my NanoClaw container agent fail to resume sessions?

Session resumption failures in the NanoClaw container agent often stem from authentication problems or inter-process IPC issues across local and Apple container runtimes, which a structured diagnostic workflow can identify.

How do I enable debug logging for a container agent?

You can enable debug logging for the container agent by following the diagnostic workflow's setup and verification steps, allowing you to capture detailed runtime information and manually test container workflows.

What is the best way to troubleshoot misconfigured mounts in a container runtime?

The best way to troubleshoot misconfigured mounts is to use a reusable quick-diagnostic script alongside manual testing steps, which surfaces actionable errors in the container environment and configuration.

Can I test inter-process IPC communication across local and Apple container runtimes?

Yes, you can test inter-process IPC communication across local and Apple container runtimes using the guided manual testing steps provided in the diagnostic workflow to verify connectivity.

What should I do if container agent authentication is not working?

If container agent authentication is not working, run the diagnostic workflow to identify the issue, verify your environment configuration, and consult documented common issues for resolving authentication problems.