debug

Diagnose containerized agent issues via logs, environment variables, mounts, and authentication.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yf8578/clawomics --skill debug-yf8578
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/yf8578/clawomics/tree/main/skills/debug
Command: npx skills add https://github.com/yf8578/clawomics --skill debug-yf8578

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve problems with the containerized agent execution system, including issues with logs, environment variables, mounts, and authentication.

Core Features & Use Cases

  • Log Analysis: Pinpoints the location and content of host and container logs for debugging.
  • Environment & Mount Verification: Guides users on how to check and fix environment variable passing and volume mounting issues within the container.
  • Common Issue Resolution: Provides step-by-step solutions for frequent errors like authentication failures, permission issues, and session resumption problems.
  • Use Case: If your agent is failing to start or encountering unexpected errors, use this Skill to systematically check container logs, verify authentication credentials, and ensure all necessary files and directories are correctly mounted.

Quick Start

Use the debug skill to check the authentication configuration for the container.

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 missing credentials?

Troubleshoot container agent authentication failures by systematically verifying credential configuration, checking environment variable propagation, and manually testing authentication procedures to pinpoint missing or invalid credentials.

Why are my environment variables not passing correctly into the containerized agent execution environment?

Environment variables fail to pass correctly into the containerized agent execution environment due to improper configuration or volume mounting issues, requiring detailed verification checks to ensure proper propagation.

How do I check container logs to debug an agent that is failing to start?

Check container logs to debug a failing agent startup by pinpointing the exact location and analyzing the content of both host and container logs to identify unexpected execution errors.

What is the best way to resolve permission restrictions and session persistence failures in a containerized agent?

Resolve permission restrictions and session persistence failures in a containerized agent by following step-by-step troubleshooting procedures that verify volume mounting and test session resumption.

Does this troubleshooting process require any specific dependencies or external tools to diagnose container issues?

This troubleshooting process requires no external dependencies to diagnose container issues, relying solely on detailed internal checks of logs, environment variables, mounts, and authentication configurations.

When should I perform manual testing procedures for container agent volume mounting issues?

Perform manual testing procedures for container agent volume mounting issues when the agent encounters unexpected errors or fails to access necessary files and directories correctly mounted in the execution environment.