debug

debug is an open-source productivity skill for Claude Code and compatible agents, published by nanocoai. Its author describes it as: “Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to understand how the container system works. Covers logs, session DBs, mounts, and common issues.”. The project has 31k stars on GitHub and is available under the MIT license. Add it to your setup with `git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/debug`.

What debug does

This guide covers debugging the containerized agent execution system.

Installation

Add debug to your agent with:

git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/debug

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for debug is organised into these sections:

• Architecture Overview
• Log Locations
• Enabling Debug Logging
• Inspecting Session DBs
• Common Issues
• 2. Container exits immediately / agent produces no reply
• 3. Mount Issues
• 4. Heartbeat / stale-session detection
• Container CLI (ncl) inside a session
• Restarting a session's container
• Manual Container Probes
• Provider SDK Options

When to use it

Reach for debug when you want productivity help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in nanocoai/nanoclaw, an established project with 30,542 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does debug do?

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

How do I install debug?

Run git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/debug in your agent, then reload your skills. Review the source at https://github.com/nanocoai/nanoclaw before installing.

Is debug free to use?

Yes. debug is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does debug come from?

debug ships inside nanocoai/nanoclaw, a repository that contains 41 catalogued skills in total. The repository's 30,542 GitHub stars apply to that whole collection, not to this skill on its own.