stuck-detection

Detect and recover from stuck patterns during multi-step task execution.

5|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/oduffy-delphi/coordinator-claude --skill stuck-detection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stuck-detection
Source: https://github.com/oduffy-delphi/coordinator-claude/tree/main/plugins/coordinator/skills/stuck-detection
Command: npx skills add https://github.com/oduffy-delphi/coordinator-claude --skill stuck-detection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This protocol helps AI agents avoid and recover from repetitive or oscillating behaviors that stall progress during complex, multi-step tasks by providing structured detection and recovery guidelines.

Core Features & Use Cases

  • Self-monitoring: maintain a dynamic TaskList to assess recent actions and contexts.
  • Pattern detection: identify repetition, oscillation, and analysis paralysis as defined in the protocol.
  • Recovery actions: switch strategies, escalate BLOCKED, and propose alternative approaches.
  • Use Case: In long planning sessions, detect when stuck and pivot to a different tactic to move forward.

Quick Start

Monitor your actions, detect the three defined stuck patterns, and switch to an alternate approach when stuck.

Frequently Asked Questions about stuck-detection

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

FAQPage Schema
How do I stop an AI agent from getting stuck in repetitive loops during multi-step tasks?

To stop an AI agent from getting stuck in repetitive loops, you need self-monitoring protocols that track recent actions and detect oscillating patterns. This skill imposes post-action checks after each tool call to identify stagnation and switch strategies.

What causes analysis paralysis in long-running agent sessions and how is it detected?

Analysis paralysis in long-running agent sessions is caused by repetitive or oscillating behaviors that stall progress. It is detected by maintaining a dynamic TaskList to assess recent actions and identify defined stuck patterns like repetition and context loss.

How do I implement a retry strategy that escalates when a multi-agent system is blocked?

To implement a retry strategy that escalates when blocked, track attempted strategies and apply post-action checks after each tool call. When patterns indicate a BLOCKED state, the system escalates and proposes alternative approaches to move forward.

Can I use self-monitoring to prevent context loss in iterative research tasks?

Yes, you can use self-monitoring to prevent context loss in iterative research tasks. By maintaining a dynamic TaskList and imposing post-action checks, the agent detects stagnation early and pivots to a different tactic to preserve context.

What is the best way to recover from planning debates that stall without making progress?

The best way to recover from planning debates that stall is to apply pattern detection to identify analysis paralysis, then switch to an alternate approach. The protocol detects when the agent is stuck and forces a tactic pivot to move forward.

Does stuck loop detection work without external dependencies or coordinator modules?

Yes, stuck loop detection works without external dependencies or coordinator modules. It operates entirely as a self-monitoring protocol, relying on internal pattern detection and dynamic TaskList tracking to manage recovery actions independently.