Individual skill
tanstack-query
TanStack Query v5 performance optimization for data fetching, caching, mutations, and query patterns. This skill should be used when using useQuery, useMutation, queryClient, prefetch patterns, or TanStack Query caching. This skill does NOT cover generating query hooks from OpenAPI (use orval skill) or mocking API responses in tests (use test-msw skill).
skills/.curated/tanstack-query/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 8,121 bytesREADME.mddoc · 1,856 bytesSKILL.mdcore · 5,276 bytesmetadata.jsonasset · 829 bytesreferences/_sections.mddoc · 1,811 bytesreferences/cache-enabled-option.mddoc · 2,010 bytesreferences/cache-global-defaults.mddoc · 2,041 bytesreferences/cache-invalidation-precision.mddoc · 2,139 bytesreferences/cache-placeholder-vs-initial.mddoc · 2,106 bytesreferences/cache-refetch-triggers.mddoc · 2,098 bytesreferences/cache-staletime-gctime.mddoc · 2,276 bytesreferences/error-conditional-retry.mddoc · 2,114 bytesreferences/error-display-patterns.mddoc · 2,270 bytesreferences/error-global-handler.mddoc · 2,230 bytesreferences/error-retry-config.mddoc · 1,869 bytesreferences/error-throw-on-error.mddoc · 2,162 bytesreferences/infinite-flatten-pages.mddoc · 2,657 bytesreferences/infinite-loading-states.mddoc · 2,462 bytesreferences/infinite-max-pages.mddoc · 2,296 bytesreferences/infinite-refetch-behavior.mddoc · 2,015 bytesreferences/mutation-avoid-parallel.mddoc · 2,014 bytesreferences/mutation-cancel-queries.mddoc · 2,047 bytesreferences/mutation-invalidate-onsettled.mddoc · 1,938 bytesreferences/mutation-optimistic-updates.mddoc · 2,323 bytesreferences/mutation-setquerydata.mddoc · 1,952 bytesreferences/prefetch-avoid-waterfalls.mddoc · 2,540 bytesreferences/prefetch-flatten-api.mddoc · 2,094 bytesreferences/prefetch-in-queryfn.mddoc · 1,972 bytesreferences/prefetch-on-hover.mddoc · 2,050 bytesreferences/prefetch-server-components.mddoc · 2,267 bytesreferences/render-notify-props.mddoc · 2,152 bytesreferences/render-select-derived.mddoc · 2,310 bytesreferences/render-select-memoize.mddoc · 2,019 bytesreferences/render-structural-sharing.mddoc · 2,251 bytesreferences/render-tracked-props.mddoc · 1,951 bytesreferences/suspense-boundaries-placement.mddoc · 2,298 bytesreferences/suspense-error-boundaries.mddoc · 2,228 bytesreferences/suspense-parallel-queries.mddoc · 2,053 bytesreferences/suspense-use-suspense-hooks.mddoc · 2,077 bytesreferences/tquery-always-arrays.mddoc · 1,403 bytesreferences/tquery-colocate-keys.mddoc · 1,858 bytesreferences/tquery-hierarchical-keys.mddoc · 1,924 bytesreferences/tquery-key-factories.mddoc · 1,750 bytesreferences/tquery-options-pattern.mddoc · 2,036 bytesreferences/tquery-serializable-objects.mddoc · 1,802 bytes
Read excerpt
# TanStack Query Best Practices
Comprehensive performance optimization guide for TanStack Query v5 applications. Contains 40 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
## When to Apply
Reference these guidelines when:
- Writing new queries, mutations, or data fetching logic
- Implementing caching strategies (staleTime, gcTime)
- Reviewing code for performance issues or request waterfalls
- Refactoring existing TanStack Query code
- Implementing infinite queries, Suspense, or optimistic updates
## Rule Categories by Priority