stuck-detector

Generate a structured handoff report with four sections when progress stalls.

4|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/danmestas/wardrobe --skill stuck-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stuck-detector
Source: https://github.com/danmestas/wardrobe/tree/main/skills/stuck-detector
Command: npx skills add https://github.com/danmestas/wardrobe --skill stuck-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The off-ramp for stalled conversations. When the agent or the user realizes the current path isn’t progressing, this skill stops the retry loop and produces a structured handoff so progress can resume in a fresh session.

Core Features & Use Cases

  • Acknowledge the stall directly and halt retries.
  • Generate a handoff report at the designated path: ~/.claude/evolution-reports/<project>/stuck/<YYYY-MM-DD>-<topic-slug>.md and include four sections: Original ask, What was tried and failed, What information would unblock progress, and Recommended next action.
  • Print the path and prompt the user with the exact question to choose: "Continue with reduced scope, escalate, or pause?"

Quick Start

Activate the stuck-detector to generate a concise handoff report and pause the session.

Frequently Asked Questions about stuck-detector

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

FAQPage Schema
How do I stop an agent retry loop when it gets stuck mid-task?

To stop an agent retry loop when stuck mid-task, you need a structured handoff mechanism that halts retries and generates a report. This skill identifies the stall, stops the loop, and creates a handoff document so progress can resume in a fresh session.

What is a structured handoff report for workflow escalation?

A structured handoff report for workflow escalation is a document capturing what was attempted, what failed, and what information is needed to unblock progress. It enables seamless context transfer to a fresh session, another user, or an escalated support tier.

How do I generate a mid-task handoff report when a workflow stalls?

To generate a mid-task handoff report when a workflow stalls, activate the stuck-detector skill. It automatically saves a markdown file to ~/.claude/evolution-reports/ containing the original ask, failed attempts, unblocking requirements, and recommended next actions.

Can I resume a stalled agent session after generating a handoff report?

Yes, you can resume a stalled agent session after generating a handoff report. The skill prompts you to choose between continuing with a reduced scope, escalating the issue, or pausing the session entirely, giving you full control over the next workflow step.

What information should be included in an escalation handoff for a stalled agent?

An escalation handoff for a stalled agent must include the original ask, what was tried and failed, what specific information would unblock progress, and a recommended next action. This structured format ensures the receiving session or user has immediate context.

When should I use a stuck detector instead of continuing to retry a failed prompt?

You should use a stuck detector when the current workflow path is no longer progressing and retries are failing. It provides an off-ramp for stalled conversations by stopping the loop and producing a structured handoff rather than wasting resources on repeated attempts.