debug

Diagnose NinjaClaw container agent failures using logs, environment variables, and mounts.

3|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/OfirGavish/NinjaClaw-Nano --skill debug-ofirgavish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/OfirGavish/NinjaClaw-Nano/tree/main/.copilot/skills/debug
Command: npx skills add https://github.com/OfirGavish/NinjaClaw-Nano --skill debug-ofirgavish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps diagnose and fix failures in the NinjaClaw container-based agent by collecting and interpreting logs, environment variables, mounts, and session data to understand why the container or Copilot SDK behaves unexpectedly.

Core Features & Use Cases

  • Comprehensive debugging guidance for container startup, log tracing, and environment setup.
  • Step-by-step checks for common issues (authentication, mounts, permissions, session resumption) with host-to-container mappings.
  • Operational playbook for reproducing issues in local, staging, or production-like containers.

Quick Start

Start a test run in a group and observe container logs to diagnose issues.

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 startup failures and runtime behavior?

To debug container agent startup failures, this skill provides step-by-step checks for container-spawn issues, log tracing, and environment setup to understand why the container behaves unexpectedly across local, staging, or production environments.

Why does my container agent fail authentication during deployment?

Container agent authentication failures are diagnosed by verifying environment variable handling and permissions. This skill offers a checklist to validate host-to-container mappings and resolve authentication problems for NinjaClaw deployments.

How do I trace container logs to diagnose environment and mount issues?

Tracing container logs involves collecting and interpreting detailed log locations, environment variables, and mount recommendations. This skill guides you through log visibility checks to pinpoint runtime behavior anomalies.

Can I use this to debug session resumption for NinjaClaw in production-like containers?

Yes, you can debug session resumption for NinjaClaw in production-like containers. This skill includes session persistence notes and host-to-container mappings to diagnose and fix session restoration problems.

What's the best way to reproduce container agent issues across different environments?

The best way to reproduce container agent issues is using an operational playbook. This skill provides checks for local, staging, and production-like containers to systematically reproduce and diagnose runtime failures.