task-debug

Diagnose failed Easy Workflow tasks by analyzing session logs and worktree state.

3|1|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/jmarceno/opencode-easy-workflow --skill task-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-debug
Source: https://github.com/jmarceno/opencode-easy-workflow/tree/main/skills/task-debug
Command: npx skills add https://github.com/jmarceno/opencode-easy-workflow --skill task-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables users to identify and fix issues in failed or misbehaving Easy Workflow tasks by analyzing logs, session histories, and worktree states, reducing manual debugging effort.

Core Features & Use Cases

  • Troubleshoot Tasks: Diagnose why tasks are failed, stuck, or not progressing by examining session logs and worktree status.
  • Verify Implementation: Check if the agent's output matches the worktree changes to ensure completion.
  • Apply Repairs: Recommend or execute appropriate recovery actions such as resetting the backlog or re-queuing implementation tasks.
  • Use Case: If a workflow task fails unexpectedly, load its logs and session timeline to determine the cause and apply an auto-repair or manual fix to resume progress.

Quick Start

Describe the issue with a specific task, then ask to analyze logs and suggest or perform repair actions.

Frequently Asked Questions about task-debug

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

FAQPage Schema
How do I debug a failed workflow task using session logs?

Debug a failed workflow task by loading its session logs and session timeline to analyze agent outputs and worktree states. This process identifies why the task failed or stalled, allowing you to apply targeted repairs and resume progress.

What is the best way to verify if an agent's implementation matches git worktree changes?

Verify agent implementation by checking if the agent's output matches the current git worktree changes. This ensures the task changes are complete and accurate, reducing manual debugging effort by confirming the worktree state aligns with expected outputs.

How do I automate recovery steps for stuck workflow tasks?

Automate recovery for stuck tasks by analyzing the session timeline and executing recommended repair actions. You can reset the backlog or re-queue implementation tasks directly to resume workflow progress without extensive manual intervention.

Why does my workflow task fail to progress despite a clean git status?

A workflow task may stall despite a clean git status due to issues in session logs or agent output indicators. Analyzing the session timeline helps diagnose hidden task failures or backlog misconfigurations to determine the exact cause.

Do I need git knowledge to troubleshoot Easy Workflow task errors?

You need basic git knowledge to troubleshoot Easy Workflow tasks, as verifying implementation completeness requires understanding git status and worktree states. This context is necessary to accurately diagnose session logs and apply appropriate error repairs.