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.