tq-triage

Diagnose failed and blocked tasks to determine actionable root causes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/michaelkd01/dic-skills --skill tq-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tq-triage
Source: https://github.com/michaelkd01/dic-skills/tree/main/tq-triage
Command: npx skills add https://github.com/michaelkd01/dic-skills --skill tq-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill gives the Orchestrator Nightly Review a disciplined process for recovering failed and blocked tasks by requiring thorough root-cause diagnosis before any reset.

Core Features & Use Cases

  • Systematic context capture: it mandates pulling acceptance criteria, execution logs, project docs, and Notion comments so nothing is missed before deciding how to act.
  • Diagnostic framework: the workflow walks through intent, failure reconstruction, root cause classification, and a recovery hypothesis for every task.
  • Controlled actions: circuit-breakers prevent unnecessary resets, retries increment responsibly, and instructions cover how to bump budgeted iterations, rewrite prompts, or escalate blockers.

Quick Start

Query the TASK QUEUE Blocked - Failed view and run the Orchestrator Nightly Review workflow, gathering every required context item before any task reset decision.

Frequently Asked Questions about tq-triage

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

FAQPage Schema
How do I diagnose root causes for blocked or failed tasks in my project queue?

To diagnose root causes for blocked or failed tasks, you must review acceptance criteria, execution logs, architecture docs, and Notion comments before resetting any task. This ensures a thorough failure reconstruction and accurate root cause classification for effective recovery.

What is the best way to run a nightly review for failed task recovery?

The best way to run a nightly review for failed task recovery is to query the Task Queue Blocked - Failed view and execute a diagnostic workflow that captures project context, classifies root causes, and generates a recovery hypothesis before taking controlled actions.

When should I increment retries or bump budgeted iterations for a blocked task?

You should increment retries or bump budgeted iterations for a blocked task only after completing a full root-cause diagnosis. Controlled actions like resetting tasks or rewriting prompts must follow a confirmed recovery hypothesis to prevent unnecessary resets.

Can I reset a failed task in Notion without reviewing execution logs and comments?

You cannot reset a failed task without reviewing execution logs and Notion comments. The triage process mandates pulling acceptance criteria, project docs, and comments to ensure no context is missed before deciding how to act on the failed task.

Why does my task triage workflow keep hitting the same blockers?

Your task triage workflow may keep hitting the same blockers if it lacks a systematic diagnostic framework. Applying intent review, failure reconstruction, and root cause classification before resetting tasks ensures you address the underlying issue rather than just retrying.

Does task triage work with Notion comments and standard project docs?

Yes, task triage works with Notion comments and standard project docs. The workflow explicitly requires gathering Notion comments, architecture docs, and acceptance criteria to build complete project context before attempting any task recovery actions.