handle_obstacle — Claude Code prompt: what it does and how to install
The handle_obstacle prompt for Claude Code and ChatGPT identifies obstacles on the current page or app. It gives a next-step hint for popups, sign-in screens, verification, access limits, or payment steps.
Apache-2.0 ★ 9,488 updated 2026-11-16
.claude/commands/handle_obstacle.mdWhat handle_obstacle does
The prompt identifies what is blocking a task on the current page or in the app, then returns a hint about what to do next. Obstacles can include a dismissible popup, a sign-in requirement, a verification puzzle, restricted site access, or a payment step.
For Claude Code, place the command file at .claude/commands/handle_obstacle.md. Its hint addresses the named obstacle; the prompt is not described as a way to bypass checks or access restrictions.
What it helps with
- identify a popup blocking a task
- decide what to do when a site requests sign-in
- get a next-step hint for a verification puzzle
- understand a site access limit or payment step
Example prompts for the agent
- Identify what is blocking this task on the current page and suggest the next step.
- This site requires sign-in. Describe the obstacle and tell me what to do next.
- The page is blocking access with verification or a payment step. Give me a next-step hint.
How to install handle_obstacle
Manually: put the files in place
.claude/commands/handle_obstacle.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about handle_obstacle
How do I install handle_obstacle in Claude Code?
Add the command file at .claude/commands/handle_obstacle.md.
What does handle_obstacle do?
It identifies a blocker on the current page or in the app and returns a hint about the next step.
Which obstacles does handle_obstacle cover?
It covers dismissible popups, sign-in requirements, verification puzzles, site access limits, and payment steps.
Source text
handle_obstacle.md · Apache-2.0
Use this when something stands between you and the task on the current app or page: a popup that can be closed, a sign-in wall, a verification puzzle, the site limiting access, or a payment step. Name it in kind; the result's hint says what to do next.
© wangzan101 · Apache-2.0 · wangzan101/Mika