click-path-audit

Trace UI handler call sequences to detect state conflicts and race conditions.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/samymity/bridge-ventures-backend --skill click-path-audit-samymity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: click-path-audit
Source: https://github.com/samymity/bridge-ventures-backend/tree/main/.claude/skills/click-path-audit
Command: npx skills add https://github.com/samymity/bridge-ventures-backend --skill click-path-audit-samymity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify why a UI touchpoint appears broken even when each individual handler function “works” on its own—typically due to sequential state updates that cancel each other out, shared-store side effects, or race conditions that leave the final UI state inconsistent with the button label.

Core Features & Use Cases

  • Sequential Undo Detection: Traces ordered calls inside a click/submit/change handler and flags cases where later calls reset or clear earlier state changes.
  • Shared State Side-Effect Mapping: Builds an action-level map of what Zustand/Redux/context store setters read/write/reset to catch “dangerous resets” that affect other UI flows.
  • Race/Staleness Checks: Evaluates async resolution order and stale closure patterns that can produce the wrong final state.
  • Use Cases: Diagnose “button does nothing” reports after refactors touching shared state stores, or after systematic debugging finds no conventional faults but users still observe broken behavior.

Quick Start

Audit the reported broken touchpoint by tracing each handler’s function calls in order, mapping store action side effects (sets vs resets), and reporting any sequential undo, async race, stale closure, missing transition, dead path, or useEffect interference that prevents the final UI state from matching the button’s promised outcome.

Frequently Asked Questions about click-path-audit

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

FAQPage Schema
Why does my UI button do nothing even though the handler function works correctly?

Race conditions in Zustand state management occur when asynchronous resolutions or stale closures produce incorrect final UI state. This Skill evaluates async resolution order and stale closure patterns to identify these timing conflicts.

How do I debug a broken frontend toggle caused by shared store side effects?

UseEffect interference happens when effects inadvertently reset or clear state changes made by event handlers. This Skill detects useEffect interference by comparing expected versus actual final UI state after handler execution.

Does this approach work for diagnosing Redux and context state stores?

Yes, this approach works for diagnosing Redux and context state stores. The Skill applies to any shared state store where setters may have side effects, mapping actions into sets and resets to catch state inconsistencies.

What's the best way to trace state undo issues after a frontend refactor?

The best way to trace state undo issues after a refactor is to audit the broken touchpoint by mapping store action side effects in order. This Skill reports sequential undo, dead paths, and missing transitions preventing correct final UI state.