debug-frontend-with-browser

Diagnose intermittent frontend bugs by tracing state across browser boundaries.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SmallAi-API/smaihub --skill debug-frontend-with-browser-smallai-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-frontend-with-browser
Source: https://github.com/SmallAi-API/smaihub/tree/main/.agents/skills/debug-frontend-with-browser
Command: npx skills add https://github.com/SmallAi-API/smaihub --skill debug-frontend-with-browser-smallai-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Intermittent UI bugs, stale state, ordering glitches, and browser-only defects are hard to reproduce and even harder to attribute to a root cause. This Skill provides a disciplined diagnostic workflow that finds the first boundary where correct data becomes incorrect, instead of guessing from symptoms. ## Core Features & Use Cases - Boundary-by-boundary tracing: Compare the same entity across DOM, renderer input, derived state, raw client state, network, and pure transformation layers to locate the first incorrect boundary. - Regression attribution: Replay a minimal sanitized fixture against a suspected commit and its real parent to separate the revision that introduced a latent bug from the data event that exposed it. - Safe isolated reproduction: Builds on the agent-testing workflow for environment isolation, fixture seeding, evidence capture, and teardown, never touching the user's production browser. - Use Case: A user reports that a deleted item reappears after switching tabs. Use this Skill to record the event timeline, compare Zustand state against the SWR cache across remount, and pinpoint the mutation that fails to invalidate the query cache. ## Quick Start Use the debug-frontend-with-browser skill to diagnose why a stale item reappears in the list after navigating away and back.

Frequently Asked Questions about debug-frontend-with-browser

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug intermittent frontend bugs that only happen in the browser?

Reproduce the defect on an isolated test surface, record the hit rate with repeated controlled actions, and capture video for time-based flicker. Then trace the same entity ID across each state boundary until you find the first layer where correct data becomes incorrect.

How to find the root cause of stale state in React apps?

Compare the same entity across DOM rows, component props, selectors, raw store records, and network responses, marking each boundary correct or incorrect. Distinguish in-memory fetch cache, Zustand state, persisted cache, and server state rather than treating them as one cache.

Why does a deleted item reappear after navigation or remount?

A mutation may update local state like Zustand but leave the query cache unchanged, so a remounted fetch hook rehydrates from the stale entry. Record the full timeline from mutation through cache invalidation, unmount, remount hydration, and revalidation to confirm.

Can this skill debug the production browser directly?

No. It requires an isolated environment and fixture strategy from the agent-testing workflow, and never uses the user's signed-in production browser as a test sandbox. Production investigation is read-only unless the user explicitly authorizes a specific live mutation.

How do I attribute a frontend regression to the right commit?

Run the same minimal fixture against the suspected revision and its real parent, comparing the same observable boundary. Verify the commit parent, PR file list, and deployment timing, and separate the revision that introduced the latent bug from the data event that exposed it.