skills.rest
omniaura
omniauraOFFICIAL
Explore all skills by this author →
GitHub

debug

Diagnose containerized agent execution issues via log analysis and environment verification.

17|3|Updated Feb 21, 2026
Search Tags:#debugging#authentication#troubleshooting#logs#permissions#agent#container
One-click install
npx skills add https://github.com/omniaura/omniclaw --skill debug-omniaura
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/omniaura/omniclaw/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/omniaura/omniclaw --skill debug-omniaura

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues with the containerized agent execution system, including container failures, authentication problems, and understanding the system's architecture.

Core Features & Use Cases

  • Log Analysis: Pinpoints locations for main app logs, container run logs, and session history.
  • Environment & Mount Verification: Provides commands to check if environment variables and file mounts are correctly configured within the container.
  • Common Issue Resolution: Offers step-by-step fixes for authentication errors, permission issues, and session persistence problems.
  • Use Case: If your agent is failing to start or process messages, use this Skill to examine container logs, verify API keys are correctly mounted, and ensure the correct user permissions are set within the container.

Quick Start

Run the quick diagnostic script to check the service status, authentication, and container runtime.

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 issues when the service fails to start?▼

To troubleshoot container agent startup failures, run a quick diagnostic script to check the service status, verify authentication configuration, and inspect the container runtime for recent errors.

Where can I find logs for diagnosing agent execution errors in a containerized environment?▼

Logs for diagnosing agent execution errors are located in the main application logs, container run logs, and session history files, which can be analyzed to pinpoint recent runtime failures.

How do I verify environment variables and file mounts are correctly configured inside my container?▼

Verifying environment variables and file mounts requires executing specific commands within the container to ensure API keys and configuration files are properly loaded and accessible by the agent.

How to fix authentication and permission errors in a containerized agent execution environment?▼

Fixing authentication and permission errors involves resolving root user restrictions, correcting API key mounts, and ensuring the correct user permissions are set within the container environment.

Why does my agent session fail to resume after a container restart?▼

Agent session non-resumption occurs when session history or persistence configurations are missing or incorrectly mounted, requiring verification of the session storage mounts within the container.

Related Skills

Explore More Software Engineering Skills→
zhaosj0315zhaosj0315

debug

Diagnose and fix containerized NanoClaw agent issues via logs and environment checks.

Community
Advanced
ClaudioCeppi83ClaudioCeppi83

error-detective

Analyze error patterns and stack traces to identify root causes.

Community
Advanced
cribclawcribclaw

setup

Automate NanoClaw installation and configuration on macOS and Linux.

Community
Advanced
arnaudjnnarnaudjnn
1

debug

Diagnoses containerized AI agent issues via logs, environment variables, volumes, and scripts.

Community
Intermediate