click-path-audit

Trace UI state changes across user interactions to uncover incorrect final states.

86|21|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Jamkris/everything-gemini-code --skill click-path-audit-jamkris
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: click-path-audit
Source: https://github.com/Jamkris/everything-gemini-code/tree/main/skills/click-path-audit
Command: npx skills add https://github.com/Jamkris/everything-gemini-code --skill click-path-audit-jamkris

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Trace every user-facing button/touchpoint through its full state change sequence to find bugs where functions individually work but cancel each other out, produce wrong final state, or leave the UI in an inconsistent state.

Core Features & Use Cases

  • For EVERY interactive touchpoint in the target area: identify the handler, trace every function call in order, determine what state it reads and writes, detect side effects on shared state, and verify that the final state matches the button label's promise.
  • Detect common bug patterns that break UX: Sequential Undo, Async Race, Stale Closure, Missing Transition, Conditional Dead Path, and useEffect Interference.
  • Produce a structured report that maps touchpoints to fixes, enabling targeted debugging after refactors or user reports.

Quick Start

Map all relevant state stores, then audit each touchpoint to generate a structured bug report.

Frequently Asked Questions about click-path-audit

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

FAQPage Schema
How do I debug React UI state issues where button handlers work individually but the final state is wrong?

Debug React UI state inconsistencies by tracing every touchpoint's handler sequence to map state reads, writes, and side effects on shared stores, producing a structured report that identifies cancellation or race patterns causing incorrect final state.

What React bug patterns cause broken UI state after a major refactor?

Broken UI state after refactors often stems from patterns like Sequential Undo, Async Race, Stale Closure, Missing Transition, Conditional Dead Path, and useEffect interference, which systematically disrupt the expected state transitions across interactive touchpoints.

How do I systematically trace state changes across user interactions to find elusive bugs?

Systematically trace state changes by mapping all relevant state stores first, then auditing each touchpoint to identify the handler, trace function calls in order, detect side effects, and verify that the final state matches the button label's promised outcome.

Does this UI state audit approach work for debugging specific pages or components?

Yes, UI state auditing targets specific pages or components by tracing every interactive touchpoint within the defined target area, validating that each handler sequence produces the correct final state without side effects on shared state stores.

What's the best way to audit useEffect interference and async race conditions in React state management?

Audit useEffect interference and async race conditions by tracing each touchpoint's full function call sequence, verifying state reads and writes to detect side effects on shared state, and highlighting patterns where asynchronous operations overwrite expected UI transitions.

How do I map all state stores before auditing UI touchpoints for inconsistent state?

Map all relevant state stores by inventorying every data source the target area touches, then audit each interactive touchpoint against this map to trace handler sequences, detect side effects, and generate a structured bug report for targeted fixes.