react-query-auditor

Audit React Query hooks for cache invalidation and race conditions.

5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/Andamio-Platform/andamio-app-template --skill react-query-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-query-auditor
Source: https://github.com/Andamio-Platform/andamio-app-template/tree/main/.claude/skills/react-query-auditor
Command: npx skills add https://github.com/Andamio-Platform/andamio-app-template --skill react-query-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses issues where user interfaces fail to update automatically after data mutations or blockchain transactions, preventing users from seeing the latest information without manual refreshes.

Core Features & Use Cases

  • Cache Invalidation Debugging: Identifies and fixes problems with React Query cache invalidation logic after mutations and transactions.
  • Stale Data Resolution: Diagnoses and resolves scenarios where stale data is displayed due to incorrect query key management or race conditions.
  • Use Case: After a user successfully submits a form, the UI doesn't reflect the new data. This Skill helps pinpoint why the relevant React Query cache wasn't invalidated, ensuring the updated data appears automatically.

Quick Start

Use the react-query-auditor skill to audit the cache invalidation logic for the updateCourse mutation in src/hooks/api/course.ts.

Frequently Asked Questions about react-query-auditor

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

FAQPage Schema
Why does my UI show stale data after a mutation in React Query?

React Query stale data after a mutation usually occurs because the relevant query cache was not invalidated. This Skill audits your mutation callbacks and query key factories to pinpoint why UI updates fail.

How do I debug cache invalidation issues in React Query?

Debug React Query cache invalidation by analyzing your mutation callbacks and transaction confirmation handlers. This Skill audits your cache invalidation patterns to ensure data freshness and accurate state reflection.

What causes race conditions in React Query data fetching?

Race conditions in React Query data fetching are caused by incorrect query key management or overlapping mutation callbacks. This Skill audits your hooks to diagnose these potential race conditions preventing seamless UI updates.

How do I ensure seamless UI updates after a blockchain transaction?

Ensure seamless UI updates post-transaction by auditing your transaction confirmation handlers and cache invalidation logic. This Skill verifies that React Query automatically reflects the latest data without manual refreshes.

Does this Skill check for type safety in React Query hooks?

Yes, this Skill audits React Query hooks for TypeScript type safety alongside cache invalidation patterns and race conditions. It guarantees data freshness and accurate state reflection across your data fetching layer.