skills.rest
Arno37
Arno37COMMUNITY
Explore all skills by this author →
GitHub

debug

Diagnose container agent issues across local and CI deployments.

Updated Mar 15, 2026
Search Tags:#debugging#authentication#troubleshooting#logs#mcp#environment#containers
One-click install
npx skills add https://github.com/Arno37/nanoclaw_test --skill debug-arno37
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/Arno37/nanoclaw_test/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/Arno37/nanoclaw_test --skill debug-arno37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging container agent issues, including authentication problems, container failures, logs, environment variables, mounts, and common configuration pitfalls, to restore normal operation.

Core Features & Use Cases

  • Diagnose container startup problems, verify environment and session persistence, review container logs, and adjust mounts and permissions for safe Claude agent execution.
  • Provide actionable steps to fix authentication failures, MCP server issues, and common misconfigurations in development and production environments.
  • Use Case: When a container-based agent fails to start or resume a session, run the diagnostic workflow to identify misconfigurations and restore normal operation.

Quick Start

Run the diagnostic script to identify and fix common container debugging issues.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot container agent authentication failures and startup errors?▼

To troubleshoot container agent authentication failures, run a structured diagnostic workflow that checks environment variables, verifies session persistence, and reviews container logs to identify and resolve misconfigurations.

Why does my container agent fail to resume a session or start properly?▼

A container agent fails to start or resume sessions due to incorrect session paths, mounting issues, or missing environment variables, which a diagnostic workflow identifies by checking mounts to /home/node/.claude and verifying configurations.

How do I enable debug logging for a container agent in a CI environment?▼

You enable debug logging for a container agent in CI deployments by following the diagnostic guidance to inspect container logs, verify environment variables, and adjust permissions for safe agent execution across local and CI environments.

Can I use this diagnostic workflow to fix MCP server issues in production containers?▼

Yes, the diagnostic workflow provides actionable steps to fix MCP server issues and common misconfigurations in both development and production environments, restoring reliable container agent operation.

What are common container misconfigurations that prevent Claude agents from running safely?▼

Common container misconfigurations include incorrect mounting to /home/node/.claude, missing environment variables, improper session paths, and permission errors, which the diagnostic script identifies and helps adjust for safe agent execution.

Related Skills

Explore More Software Engineering Skills→
leonj1leonj1

debug

Diagnose NanoClaw container runtime issues via logs, env vars, and mounts.

Community
Basic
theowenyoungtheowenyoung

debug

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

Community
Intermediate
clsandovalclsandoval

debug

Diagnose NanoClaw container issues by inspecting logs, environments, and mounts.

Community
Intermediate
openkaidenopenkaiden
3

debug-image

Inspect container images and replicate integration test failures via shell access.

Official
Intermediate