diagnose — Claude Code prompt: screen checks and installation
The diagnose Claude Code prompt identifies why a screen cannot be used: it is blank, loading, locked, or protected. If human input is needed, the agent hands the step to the user.
Apache-2.0 ★ 9,488 updated 2026-11-16
.claude/commands/diagnose.mdWhat diagnose does
The prompt checks why a screen is unusable. It identifies a blank screen, an ongoing load, a lock, or protection, then reports the result through usable, state, and hint.
When needsHuman is true, the agent passes the next step to the user instead of continuing to tap around.
What it helps with
- identify why a screen is blank
- check whether a screen is still loading
- detect a locked or protected screen
- hand a step to the user when human input is needed
Example prompts for the agent
- Find out why this screen cannot be used.
- Check whether the screen is blank, loading, locked, or protected.
- If a person needs to take over, pass the next step to me.
How to install diagnose
Manually: put the files in place
.claude/commands/diagnose.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about diagnose
How do I install diagnose in Claude Code?
Add the prompt as .claude/commands/diagnose.md.
What does diagnose do?
It identifies why a screen cannot be used and reports the result through usable, state, and hint.
What happens when a screen needs human input?
When needsHuman is true, the agent hands the step to the user instead of tapping around.
Source text
diagnose.md · Apache-2.0
Find out why this screen is unusable: blank, still loading, locked or protected. Look at usable, state and hint in the result. When needsHuman is true, hand the step to the user instead of tapping around.
© wangzan101 · Apache-2.0 · wangzan101/Mika