debug-task

Trace agent task failures to their root cause using logs, databases, transcripts, and wrapper scripts.

40|8|Updated May 14, 2026
One-click install
npx skills add https://github.com/zpoint/vibe-seller --skill debug-task-zpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-task
Source: https://github.com/zpoint/vibe-seller/tree/main/.claude/skills/debug-task
Command: npx skills add https://github.com/zpoint/vibe-seller --skill debug-task-zpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the guesswork when AI agent tasks fail due to infrastructure issues like wrong working directories, missing files, browser startup failures, or skill loading problems. Instead of blaming the agent, it traces every detour and retry to its root cause in the platform code, configuration, or prompts.

Core Features & Use Cases

  • Infrastructure Root Cause Analysis: Identifies whether failures stem from catalog path bugs, skill loading issues, CDP proxy problems, or workspace isolation gaps.
  • Log-Driven Debugging: Mandates reading actual agent debug logs and transcripts before forming conclusions, preventing assumptions from file existence or task messages alone.
  • Cross-Platform Topology Detection: Handles the complexity of WSL-to-Windows deployments where native Windows servers and WSL environments have separate data directories, preventing stale database reads.

Quick Start

Use the debug-task skill to investigate why a recent agent task failed to load its skills or started in the wrong working directory by analyzing the backend logs and task transcript.

Frequently Asked Questions about debug-task

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

FAQPage Schema
Why do my agent tasks fail to load skills or start in the wrong working directory?

Agent tasks fail to load skills or start in the wrong working directory due to infrastructure issues like catalog path bugs or workspace isolation gaps. Analyzing backend logs and task transcripts traces these detours to their specific root cause in the platform code or configuration.

How do I debug AI agent execution failures using backend logs?

Debug AI agent execution failures by reading actual agent debug logs and SQLite task databases before forming conclusions. This log-driven debugging approach prevents assumptions from file existence alone and traces failures to specific code or configuration root causes.

Can I diagnose agent infrastructure issues across WSL and native Windows deployments?

Yes, you can diagnose agent infrastructure issues across WSL and native Windows deployments. Cross-platform topology detection handles environments with separate data directories, preventing stale database reads when native Windows servers and WSL operate simultaneously.

What is the best way to find the root cause of browser startup failures in automated agents?

The best way to find the root cause of browser startup failures is analyzing CDP proxy problems and agent wrapper scripts. Tracing the execution infrastructure reveals whether the failure stems from configuration gaps or browser control protocol issues.

How do I investigate missing files during agent task execution?

Investigate missing files during agent task execution by analyzing backend logs and agent transcripts rather than relying on task messages alone. This identifies whether the issue stems from catalog path bugs or workspace isolation gaps in the infrastructure.

Agent execution bugs not working after cross-platform deployment, what are the limitations?

Cross-platform deployment limitations include stale database reads when WSL and native Windows environments maintain separate data directories. Analyzing the SQLite task database and wrapper scripts ensures accurate topology detection across isolated store agents.