when-stuck

Identify stuck types and apply corresponding techniques from a dispatch table.

14|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/a-ariff/ariff-claude-plugins --skill when-stuck-a-ariff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: when-stuck
Source: https://github.com/a-ariff/ariff-claude-plugins/tree/main/plugins/when-stuck/skills/when-stuck
Command: npx skills add https://github.com/a-ariff/ariff-claude-plugins --skill when-stuck-a-ariff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When progress stalls, deciding which technique to apply is hard; this skill provides a dispatch table and structured guidance to select the right approach.

Core Features & Use Cases

  • Dispatch table mapping stuck types to techniques
  • Step-by-step guidance for common stuck scenarios
  • Integration with other skills for deeper analysis

Quick Start

Identify your stuck type (e.g., don't understand, can't find code) and apply the corresponding technique from the dispatch table.

Frequently Asked Questions about when-stuck

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

FAQPage Schema
How do I identify what type of problem is blocking my progress in software development?

Progress blockers fall into distinct types: unclear requirements, missing context, code or test failures, and scope creep. Identifying your stuck type is the first step to selecting the right resolution technique. This Skill maps each type to a specific approach for unblocking your workflow.

What techniques should I use when I'm stuck on a software problem?

The Skill provides a dispatch table matching stuck types to targeted techniques. Each technique offers step-by-step guidance tailored to your blocker—whether you need clarification, code discovery, debugging steps, or scope realignment. Apply the technique corresponding to your stuck type for concrete next steps.

Can I use this for interactive AI coaching workflows?

Yes. The Skill applies to both interactive AI coaching and software development workflows. It recognizes stuck states across both contexts and deploys corresponding techniques, making it useful wherever progress stalls due to unclear requirements, missing context, or scope issues.

How does this Skill help when my code tests are failing?

Code and test failures are one stuck type the Skill recognizes. It maps that failure state to debugging and diagnostic techniques, providing structured guidance to identify the root cause and generate executable next steps to resolve the failure.

What's the difference between this problem-solving approach and just trying random fixes?

This Skill uses a structured dispatch table to match your specific blocker type to a proven technique, rather than random attempts. Mapping stuck state to technique produces concrete, executable next steps and automation triggers—saving time and reducing frustration.