debug

Diagnose container agent issues by inspecting logs, environment variables, and mounts.

50|4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/sliamh11/Deus --skill debug-sliamh11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/sliamh11/Deus/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/sliamh11/Deus --skill debug-sliamh11

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

Architecture overview and debugging workflow including log locations, environment variable checks, permission and mount troubleshooting, and session resumption notes. Handles common failure modes in containerized Claude deployment and allows quick root-cause analysis across dev environments.

Quick Start

Run the agent with debug logging enabled and inspect the main logs and container run logs to surface the root cause.

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 issues when authentication fails?

Debug container agent authentication failures by inspecting environment variables, checking mount configurations for permission issues, and reviewing main logs to surface the root cause of the access problem.

What is the best way to analyze container logs for deployment failures?

Analyze container logs for deployment failures by enabling debug logging, inspecting the main logs alongside container run logs, and tracing error scenarios through the container-runner architecture workflow.

Why does my container fail to resume sessions across local development environments?

Container session resumption fails when mount configurations are misconfigured or environment variables are missing. Inspect mount points and verify environment variable persistence across your dev environments.

How do I troubleshoot container mount and permission issues?

Troubleshoot container mount and permission issues by inspecting mount configurations, verifying environment variables, and checking log locations to identify permission-denied errors or path resolution failures.

Where are container agent logs stored for debugging workflows?

Container agent logs are stored in specific log locations defined by the container-runner architecture. Enable debug logging and inspect both main logs and container run logs to trace the workflow and identify errors.