session recap · 2026-06-02

sonnet-4-6

Diagnosed and fixed the Playwright element screenshot bug in the social-media-tools rendering pipeline — the browser_snapshot step was missing, causing full-page captures instead of cropping to the .card element.

Root-caused full-page screenshot: browser_take_screenshot needs an element ref from browser_snapshot
Added browser_snapshot step to rendering-pipeline.md — affects all 7 share skills
Added browser_snapshot to the ToolSearch selector for deferred-tool environments
Added CHANGELOG v2.5.1 entry documenting the fix

18,179 tokens 7 min 94.7% cache hit 2 files 0 commits

Tracked down a subtle Playwright bug in the Claude Code social-media-tools rendering pipeline today.

The symptom: every share-session card was screenshotting the entire page instead of cropping to the .card element. The `target: ".card"` parameter looked correct — but the output was always full-viewport.

Root cause: `browser_take_screenshot` needs an element `ref` from a prior `browser_snapshot` call, not just a CSS selector passed cold. Without the snapshot, Playwright silently falls back to full-viewport capture with no error.

The fix: add a `browser_snapshot` step between page load and screenshot, grab the `.card` ref, and pass it as `target`. One change to a shared reference file — all 7 share skills fixed at once.

The lesson: silent fallback behavior is the hardest kind to debug. No error, no warning — just wrong output until you read the schema.

Follow for more Claude Code debugging and agent workflow patterns.

#ClaudeCode #Playwright #Debugging

Twitter/X

Playwright's browser_take_screenshot silently falls back to full-page when target has no element ref from a prior browser_snapshot.

Fix: snapshot first → grab the .card ref → pass it as target.

No error. No warning. Just wrong output until you read the schema.

Bluesky

Tracked down why share-session cards were always full-page screenshots. Missing browser_snapshot step — Playwright needs a real DOM ref, not a bare CSS selector, to crop screenshots. Silent fallback, no error. One step added, 7 skills fixed.

Substack

Today's session was a single quiet bug with a satisfying root cause.

Every share-session card was screenshotting the whole page instead of the card element. The pipeline said `target: ".card"` — which looked right — but output was always full-viewport.

Root cause: Playwright's `browser_take_screenshot` needs an element `ref` from a prior `browser_snapshot`, not just a CSS selector. No ref → silent full-page fallback. No error, no warning.

One snapshot step added. All seven share skills fixed at once.

Follow for more agent debugging and Claude Code workflow patterns.