debug

Analyzes agent/subprocess logs and adjusts configurations to resolve execution failures.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/sasha-computer/2026 --skill debug-sasha-computer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/sasha-computer/2026/tree/main/gandalf/.claude/skills/debug
Command: npx skills add https://github.com/sasha-computer/2026 --skill debug-sasha-computer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve problems encountered during the execution of agent processes, including authentication failures and subprocess system errors.

Core Features & Use Cases

  • Log Analysis: Provides access to various log files for detailed error tracing.
  • Environment Configuration: Guides on setting environment variables for debugging.
  • Common Issue Resolution: Offers solutions for common problems like authentication errors, timeouts, and output truncation.
  • Use Case: When an agent fails to start or produces unexpected output, use this Skill to examine logs, check API keys, and adjust configuration settings.

Quick Start

Use the debug skill to examine the agent run logs for the most recent execution.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I troubleshoot agent execution failures using logs?

Troubleshoot agent execution failures by examining host and agent logs to trace errors, verify authentication credentials, and adjust subprocess configurations for native agent systems.

Why does my agent subprocess produce unexpected output or fail to start?

Agent subprocess failures and unexpected output often stem from IPC communication errors, output truncation, or incorrect environment variables; analyze execution logs and adjust configuration settings to resolve them.

How do I fix authentication errors during agent process execution?

Fix agent authentication errors by verifying API keys, checking environment variable settings, and reviewing authentication credentials within the host and agent logs to ensure proper validation.

What environment variables do I need to configure for debugging agent systems?

Debugging agent systems requires configuring environment variables that control authentication credentials and subprocess execution, ensuring proper IPC communication and output handling during troubleshooting.

How do I resolve timeouts and output truncation in subprocess agent systems?

Resolve timeouts and output truncation in subprocess agent systems by analyzing detailed host logs and adjusting subprocess configurations to handle IPC communication and output limits properly.

Do I need access to log files to debug native subprocess agent systems?

Yes, troubleshooting native subprocess agent systems requires access to host and agent log files alongside environment variable settings to accurately trace IPC communication and resolve execution issues.