debug

Analyzes logs, environment variables, mounts, and session data to identify root causes of NanoClaw/FlexClaw container issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to understand how the container system works. Covers logs, environment variables, mounts, and common issues.

Core Features & Use Cases

  • Architecture overview and debugging workflow for NanoClaw/FlexClaw
  • Log location mapping, enabling debug logging, and identifying container spawn issues
  • Guidance on sessions, mounts, and IPC for reliable resumption and isolation

Quick Start

Invoke the debug skill to inspect container logs, environment setup, and mounts to resolve common agent problems.

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 issues when authentication or spawn fails?

Debug container agent issues by inspecting logs, environment variables, mounts, and session data to pinpoint root causes. It applies to NanoClaw and FlexClaw workflows, offering structured guidance to resolve container spawn failures and authentication problems.

Where are container agent logs located and how do I enable debug logging?

Container agent log locations are mapped within the container environment, and enabling debug logging captures detailed runtime data. This skill identifies log paths and guides structured debugging workflows for containerized agent systems.

What is the best way to diagnose IPC and mount issues in a containerized agent workflow?

Diagnose IPC and mount issues by inspecting session data and mount configurations to ensure reliable resumption and container isolation. This skill provides targeted guidance for resolving these specific container agent failures.

Why does my container agent session fail to resume after a restart?

Container agent session resumption fails when session data, IPC channels, or mount configurations disrupt container isolation. This skill analyzes session persistence and environment variables to identify the root cause of resumption failures.

Can I use this debugging workflow for NanoClaw and FlexClaw container environments?

Yes, the debugging workflow applies to both NanoClaw and FlexClaw container environments. It covers architecture overviews, log locations, environment setup, and session isolation to resolve agent problems across these specific contexts.