debug

Diagnose containerized AI agent issues via log analysis and configuration checks.

13|2|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/NebulaMao/nanoiflow --skill debug-nebulamao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/NebulaMao/nanoiflow/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/NebulaMao/nanoiflow --skill debug-nebulamao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose and resolve problems with containerized AI agents, including issues with execution, authentication, and system configuration.

Core Features & Use Cases

  • Log Analysis: Pinpoint errors by examining host and container logs.
  • Configuration Verification: Check environment variables, mount points, and permissions within the container.
  • Troubleshooting Common Errors: Guides you through fixing issues like missing authentication, permission errors, and session resumption failures.
  • Use Case: If your AI agent is failing to start or encountering authentication errors, use this Skill to systematically check logs, environment variables, and mount configurations to identify and fix the root cause.

Quick Start

Run the diagnostic script to check for common container setup issues.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot a containerized AI agent that fails to start?

To troubleshoot containerized AI agent startup failures, examine host and container logs, verify environment variables, and validate mount point configurations to isolate the root cause.

Why does my iFlow SDK agent encounter authentication failures in Docker?

Authentication failures in Docker AI agents often stem from missing environment variables or incorrect mount point permissions, which you can diagnose by verifying container configuration.

How do I check Docker mount points for permission errors in isolated Linux containers?

To check Docker mount points for permission errors in isolated Linux containers, validate the mount configurations and verify environment variables to ensure proper access controls.

Can I use this approach to fix AI agent session persistence failures?

Yes, you can fix AI agent session persistence failures by systematically diagnosing container logs, verifying mount points, and checking environment variables within the isolated environment.

What is the best way to analyze container logs for troubleshooting agent execution issues?

The best way to analyze container logs for troubleshooting agent execution issues is to systematically examine both host and container logs to pinpoint errors, authentication failures, and permission problems.