Skip to content

Commit ef8e5cc

Browse files
authored
[Skill] Teach agents to diagnose PPR error overlay in locked screenshots (#30)
1 parent 3b0c9f8 commit ef8e5cc

File tree

2 files changed

+11
-1
lines changed

2 files changed

+11
-1
lines changed
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@vercel/next-browser": patch
3+
---
4+
5+
Teach agents to diagnose PPR error overlay in locked screenshots

skills/next-browser/SKILL.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -377,7 +377,12 @@ blockers) not already in the table.
377377

378378
**`errors` doesn't report while locked.** If the shell looks wrong (empty,
379379
bailed to CSR), unlock and `goto` the page normally, then run `errors`.
380-
Don't debug blind under the lock.
380+
Don't debug blind under the lock. A common symptom: the PPR shell
381+
screenshot shows the Next.js error overlay (a white box with "Runtime
382+
Error" and a call stack). This means the page errored during prerender,
383+
but you can't read the error details from the screenshot alone. Unlock,
384+
navigate to the page normally (`goto`), then run `errors` to get the
385+
full error message and stack trace.
381386

382387
**Full bailout (scrollHeight = 0).** When PPR bails out completely, `unlock`
383388
returns just "unlocked" with no shell analysis — there are no boundaries to

0 commit comments

Comments
 (0)