browser-edge-cases
SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
npx skills add aden-hive/hive --skill browser-edge-cases --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Browser Tool Edge Cases Standard Operating Procedure for debugging and fixing browser automation failures on complex websites. ## When to Use This Skill - `browser_scroll` succeeds but page doesn't move - `browser_click` succeeds but no action triggered - `browser_type` text disappears or doesn't work - `browser_snapshot` hangs or returns stale content - `browser_navigate` loads wrong content ## SOP: Debugging Browser Tool Failures ### Phase 1: Reproduce & Isolate ``` 1. Create minimal test case demonstrating failure 2. Test against simple site (example.com) to verify tool works 3. Test against problematic site to confirm issue ``` **Quick isolation test:** ```python # Test 1: Does the tool work at all? await browser_navigate(tab_id, "https://example.com") result = await browser_scroll(tab_id, "down", 100) # Should work on simple sites # Test 2: Does it fail on the problematic site? await browser_navigate(tab_id, "https://linkedin.com/feed") result = await browser_scroll(tab_id, "down", 100) # If this fails but example.com works → site-specific edge case ``` ### Phase 2: Analyze Root Cause **Step 2a: Check console for errors** ```python console = await browser_console(tab_id) # L
- When to Use This Skill
- SOP: Debugging Browser Tool Failures
- Phase 1: Reproduce & Isolate
- Phase 2: Analyze Root Cause
- Phase 3: Implement Multi-Layer Fix
- Phase 4: Verify Fix
- Pattern Library
- P1: Nested Scrollable Containers
- P2: Element Covered by Overlay
- P3: React Synthetic Events
- P4: Huge DOM / Accessibility Tree
- P5: SPA Hydration Delay
- P6: Shadow DOM
- Quick Reference
What does the browser-edge-cases skill do?
SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
How do I install it?
Run `npx skills add aden-hive/hive --skill browser-edge-cases --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From aden-hive/hive, a repository with 10,850 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.