Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/arraydude/agent-skills/react-query-best-practicesnpx skills add arraydude/agent-skills --skill react-query-best-practicesgit clone --depth 1 https://github.com/arraydude/agent-skillsWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00062 | $0.01309 |
| Opus 5 | $0.00031 | $0.00655 |
| Sonnet 5 | $0.00012 | $0.00262 |
| Haiku 4.5 | $0.00006 | $0.00131 |
Grade A, and why
react-query-best-practices scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.
React Query Best Practices
Important: This guide targets React Query v4. Some patterns may differ in v5.
Comprehensive guide for React Query v4 (TanStack Query) based on TkDodo's authoritative blog series. Contains 24 rules across 7 categories, prioritized by impact.
When to Apply
Reference these guidelines when:
- Implementing new queries or mutations
- Integrating WebSockets with React Query
- Setting up query invalidation patterns
- Debugging React Query behavior
- Optimizing render performance
- TypeScript integration questions
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Query Keys & Patterns | CRITICAL | query- |
| 2 | Mutations & Updates | CRITICAL | mutation- |
| 3 | Caching Strategy | HIGH | cache- |
| 4 | WebSocket Integration | HIGH | websocket- |
| 5 | TypeScript Integration | MEDIUM | typescript- |
| 6 | Testing Patterns | MEDIUM | testing- |
| 7 | Common Pitfalls | MEDIUM | troubleshoot- |
| 8 | Migration to v5 | HIGH | migration- |
Quick Reference
1. Query Keys & Patterns (CRITICAL)
query-keys-as-dependencies- Include all queryFn params in queryKeyquery-key-factory- Use factory pattern for consistent key generationquery-select-transforms- Use select option for data transformationsquery-status-check-order- Check data first, then error, then loadingquery-tracked-properties- Only destructure properties you usequery-placeholder-vs-initial- Know when to use each approachquery-dependent-enabled- Use enabled option for dependent queries
2. Mutations & Updates (CRITICAL)
mutation-prefer-mutate- Use mutate() with callbacks over mutateAsync()mutation-invalidation- Invalidate queries after mutationsmutation-direct-cache-update- Update cache directly when appropriatemutation-optimistic-updates- Show success immediately, rollback on failuremutation-callback-separation- Query logic in hook, UI effects in component
What ships with it
39 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- AGENTS.md 29 KB
- rules/cache-refetch-triggers.md 971 B
- rules/cache-stale-time.md 976 B
- rules/migration-cache-time-to-gc-time.md 971 B
- rules/migration-context-to-query-client.md 930 B
- rules/migration-hydration-boundary.md 1.2 KB
- rules/migration-initial-page-param.md 1.2 KB
- rules/migration-keep-previous-data.md 1.3 KB
- rules/migration-misc-breaking-changes.md 1.9 KB
- rules/migration-query-callbacks-removed.md 1.3 KB
- rules/migration-refetch-interval-callback.md 924 B
- rules/migration-refetch-page-to-max-pages.md 1.1 KB
- rules/migration-remove-method.md 942 B
- rules/migration-single-signature.md 1.5 KB
- rules/migration-status-pending.md 1.3 KB
- rules/migration-suspense-hooks.md 1.1 KB
- rules/migration-throw-on-error.md 1.1 KB
- rules/mutation-callback-separation.md 1.1 KB
- rules/mutation-direct-cache-update.md 1.2 KB
- rules/mutation-invalidation.md 1.0 KB
- rules/mutation-optimistic-updates.md 1.2 KB
- rules/mutation-prefer-mutate.md 1.2 KB
- rules/query-dependent-enabled.md 1.0 KB
- rules/query-key-factory.md 1.3 KB
- rules/query-keys-as-dependencies.md 893 B
- rules/query-placeholder-vs-initial.md 1.2 KB
- rules/query-select-transforms.md 1.1 KB
- rules/query-status-check-order.md 1.1 KB
- rules/query-tracked-properties.md 615 B
- rules/testing-fresh-client.md 1.4 KB
- rules/testing-msw-mocking.md 1.2 KB
- rules/troubleshoot-copy-to-state.md 981 B
- rules/troubleshoot-fetch-not-reject.md 911 B
- rules/troubleshoot-missing-key-deps.md 961 B
- rules/typescript-infer-dont-specify.md 1.2 KB
- rules/typescript-zod-validation.md 880 B
- rules/websocket-event-invalidation.md 1.4 KB
- rules/websocket-reconnection.md 1.1 KB
- rules/websocket-stale-time-infinity.md 807 B
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 129 lines · 62 tokens per session scan A 82bcaf5477d3
react-query-best-practices is a skill published in the GitHub repository arraydude/agent-skills (2 stars, last pushed 1mo ago), licensed MIT. It adds 62 tokens to every session and 1,309 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
chat-pet-sprite-creation
Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.
cpu-profile-analysis
Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…
babysit-pr
Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…
imagegen
Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…
agent-host-chat-contributions
Build and review cross-cutting agent-host chat behavior through lifecycle contributions. Use when adding turn lifecycle side effects, prompt or context injection, restored-history transformation, protocol-action observation, or when reviewing changes that add code to AgentSideEffects or AgentService.