| name | Get Unstuck |
| description | Pause, surface the current plan + open questions, and suggest the next concrete step so the agent (or operator) can recover from a deadlock or analysis paralysis. |
| category | meta |
| effort | low |
| when_to_use | When the conversation has been spinning — repeated tool calls without progress, contradictory edits, the agent admitting it doesn't know what to do next, or the operator typing "you're stuck" / "let's try again". Don't use this as a first response — use it when the rope's already in a knot. |
| version | 1.0.0 |
Stuck — recovery checklist
Stop. Don't make another tool call. Read this whole skill before
deciding what to do next.
What "stuck" actually looks like
You probably got here because one of these is true:
- The same file keeps being edited and reverted, or the same tool
keeps being called with slightly different inputs and the same
result.
- You've explained a plan three different ways and the user is
still unhappy.
- A test / build keeps failing and your fixes aren't moving the
failure mode, just relocating it.
- You're about to open a PR / send a commit but you can't summarise
what changed.
If none of those describe the moment, this skill probably isn't
what you needed.
Recovery — five-step recipe
1. State the original goal in one sentence
What was the user's original ask? Not your interpretation, not
the third-derivative subgoal you ended up chasing. The literal
prompt or its plain-English rephrasing.
2. List what's actually been done
Not what you tried, not what you intended. What's committed to
disk or visible in the conversation right now. Bullet list of
≤ 5 items.
3. List the open question(s)
What single piece of information would unblock you? It's almost
always one of:
- A clarification from the user (which of two interpretations,
what counts as "done", which file is canonical).
- A reading you skipped (a config you haven't opened, a log line
you haven't grepped, a manifest you assumed about).
- A test / repro you don't have (you're pattern-matching on a bug
report instead of running the code).
4. Propose one concrete next step
Pick the smallest action that produces new information. Not a
plan, not a refactor — one Read, one Bash command, one user
question. The goal is to break the symmetry of being stuck.
5. Surface a "stop here?" prompt
End with a single yes/no question to the user. Examples:
- "I think the issue is X. Should I try Y, or did you mean Z?"
- "Before I keep editing, can you confirm the file at PATH is the
right one?"
- "I've made N changes; should I commit what's there now and
continue from a clean state?"
Make the question answerable with one short reply. The point is
to put the user back in the driver's seat without dumping your
state on them.
What to avoid in this skill
- Don't write code.
- Don't make tool calls (Read / Bash / Edit / etc.) inside this
skill — that's how you got stuck.
- Don't apologise more than once.
- Don't propose three options. One next step, one question.
After the user replies
Discard the rest of your prior plan. Treat the user's answer as the
new starting point. The whole point of this skill is to reset,
not to continue.