Overview
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.
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
Installation
Add debug to your agent with:
git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/debugReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — declared in the repository topics
License
debug is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in nanocoai/nanoclaw, an established project with 30,542 GitHub stars
- Works with Claude Code
- Actively maintained — repository updated in the last 90 days
Author
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.
- Which agents does debug work with?
- debug lists Claude Code — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- 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.