when-stuck

Diagnose blocked tasks and propose structured remedies via a decision tree.

3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/opzero1/op1 --skill when-stuck-opzero1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: when-stuck
Source: https://github.com/opzero1/op1/tree/main/packages/install/templates/skill/when-stuck
Command: npx skills add https://github.com/opzero1/op1 --skill when-stuck-opzero1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly diagnose why work is blocked and selects an effective strategy to move forward, reducing time wasted in trial-and-error.

Core Features & Use Cases

  • Diagnosis prompts: Provides a structured decision tree to identify whether the block is due to complexity, understanding gaps, environment mismatch, edge cases, or integration issues.
  • Guided strategies: Offers step-by-step strategies to isolate, test, and resolve each type of blockage.
  • Use Case: A developer stuck on a multi-module issue can follow the tree to choose a focused approach and unblock progress.

Quick Start

Run the when-stuck skill with your current problem description to obtain a recommended path and concrete next steps.

Frequently Asked Questions about when-stuck

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

FAQPage Schema
How do I diagnose why a software development task is blocked?▼

To troubleshoot a blocked workflow, use a decision tree to isolate the root cause among complexity, understanding gaps, environment mismatches, edge cases, or integration issues, then apply a targeted strategy.

What is the best way to troubleshoot complex debugging blockers?▼

The best way to troubleshoot complex debugging blockers is following a guided, step-by-step strategy that isolates the specific block type and proposes a focused remedy to resume progress.

How do I isolate environment mismatches and integration issues during project workflows?▼

To isolate environment mismatches and integration issues during project workflows, follow guided strategies that test and resolve each specific blockage type identified through a structured decision tree.

Can I use a decision tree to resolve multi-module development issues?▼

Yes, you can use a decision tree to resolve multi-module development issues by guiding you through common stuck-types to choose a focused approach and unblock progress quickly.

Does this debugging approach work for project workflows outside of software engineering?▼

Yes, this debugging approach works for project workflows outside of software engineering, as the decision tree methodology applies to any scenario where blockers arise and require a structured remedy.