Agent skill

With Tanstack Query

by octanejs in octanejs/octane

Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data.

MITAuto-check passedDevelopment

Install With Tanstack Query

skills CLI
$ npx skills add octanejs/octane --skill with-tanstack-query -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install octanejs/octane with-tanstack-query --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/octanejs/octane.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/tanstack-table/upstream/skills/with-tanstack-query .claude/skills/with-tanstack-query && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
with-tanstack-query
GitHub stars
1.4k
Token cost
~1.1k tokens
SKILL.md length
160 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data.

  • Development work in your project
  • SKILL.md covers Setup, Core Patterns, Common Mistakes and API Discovery
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

With Tanstack Query is an agent skill from octanejs/octane. Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data. Load for query-key table state, manual processing boundaries, server rowCount, keepPreviousData, or avoiding duplicated query-result state.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with TanStack and React. The repository describes itself as: React’s programming model, compiled. The successor to Inferno. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/with-tanstack-query”

What it can do on your machine

Read from SKILL.md and the folder at commit 40fdefd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

With Tanstack Query loads about 1.1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 160 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from octanejs/octane at commit 40fdefd, republished under its MIT licence (© octanejs). 160 words, ~1,110 tokens.

Download SKILL.mdSave it as .claude/skills/with-tanstack-query/SKILL.md (or your agent's skills folder).
name
with-tanstack-query
description
Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data. Load for query-key table state, manual* processing boundaries, server rowCount, keepPreviousData, or avoiding duplicated query-result state.
metadata.type
composition
metadata.library
@tanstack/react-table
metadata.library_version
9.2.4
metadata.framework
react
requires
@tanstack/table-core#client-vs-server, getting-started, table-state
sources
TanStack/table:examples/react/with-tanstack-query, TanStack/table:examples/react/virtualized-infinite-scrolling…

This skill builds on @tanstack/table-core#client-vs-server, getting-started, and table-state. Query owns fetching/cache; Table owns grid state and receives rows already processed by every manual server stage.

Setup

tsx
import { keepPreviousData, useQuery } from '@tanstack/react-query'
import { useCreateAtom, useSelector } from '@tanstack/react-store'
import {
  rowPaginationFeature,
  tableFeatures,
  useTable,
} from '@tanstack/react-table'
import type { PaginationState } from '@tanstack/react-table'

const features = tableFeatures({ rowPaginationFeature })
const emptyRows: Array<{ id: string }> = []

function ServerTable() {
  const paginationAtom = useCreateAtom<PaginationState>({
    pageIndex: 0,
    pageSize: 20,
  })
  const pagination = useSelector(paginationAtom, (value) => value)
  const result = useQuery({
    queryKey: ['people', pagination],
    queryFn: async () =>
      fetch(
        `/api/people?page=${pagination.pageIndex}&size=${pagination.pageSize}`,
      ).then(
        (r) =>
          r.json() as Promise<{
            rows: Array<{ id: string }>
            rowCount: number
          }>,
      ),
    placeholderData: keepPreviousData,
  })
  return useTable({
    features,
    columns,
    data: result.data?.rows ?? emptyRows,
    rowCount: result.data?.rowCount,
    atoms: { pagination: paginationAtom },
    manualPagination: true,
  })
}

Core Patterns

Put every server-owned slice in the key
tsx
const result = useQuery({
  queryKey: ['people', pagination, sorting, columnFilters],
  queryFn: () => fetchPeople({ pagination, sorting, columnFilters }),
})
Feed the query result directly to Table
tsx
const table = useTable({
  features,
  columns,
  data: result.data?.rows ?? emptyRows,
})

Common Mistakes

HIGH Duplicating query rows into state

Wrong:

tsx
useEffect(() => setRows(result.data?.rows ?? []), [result.data])
const table = useTable({ features, columns, data: rows })

Correct:

tsx
const table = useTable({
  features,
  columns,
  data: result.data?.rows ?? emptyRows,
})

The second state layer can lag behind the query cache and creates an extra synchronization path.

Source: examples/react/with-tanstack-query

HIGH Omitting state from the query key

Wrong:

tsx
useQuery({ queryKey: ['people'], queryFn: () => fetchPeople({ pagination }) })

Correct:

tsx
useQuery({
  queryKey: ['people', pagination],
  queryFn: () => fetchPeople({ pagination }),
})

Query otherwise reuses cache entries for different server requests.

Source: examples/react/with-tanstack-query

HIGH Expecting manual mode to fetch

Wrong:

tsx
useTable({ features, columns, data, manualPagination: true })

Correct:

tsx
useTable({
  features,
  columns,
  data: result.data?.rows ?? emptyRows,
  rowCount: result.data?.rowCount,
  manualPagination: true,
})

manualPagination only bypasses client pagination; the application must fetch a processed page and provide its total count.

Source: docs/framework/react/guide/pagination.md

MEDIUM Flashing an empty page during fetch

Wrong:

tsx
useQuery({
  queryKey: ['people', pagination],
  queryFn: () => fetchPeople({ pagination }),
})

Correct:

tsx
useQuery({
  queryKey: ['people', pagination],
  queryFn: () => fetchPeople({ pagination }),
  placeholderData: keepPreviousData,
})

Preserve the previous page intentionally when an empty loading transition is undesirable.

Source: examples/react/with-tanstack-query

API Discovery

Inspect node_modules/@tanstack/react-table/dist/index.d.ts and the relevant core feature source; inspect the installed @tanstack/react-query source for current query option types.

© octanejs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/tanstack-table/upstream/skills/with-tanstack-query of octanejs/octane.

Open the folder on GitHubat commit 40fdefd

Compare with similar skills

With Tanstack Query next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

With Tanstack Query compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
With Tanstack Query this skilloctanejs/octane1.4k—~1.1kAutomated safety check: PassMIT
Wagmi Feature Developmentwevm/wagmi6.8k—~3.8kAutomated safety check: PassMIT
Cleanup Specialistahaodev/shadmin174—~1.3kAutomated safety check: PassMIT
Tanstack Router Best PracticesDeckardGer/tanstack-agent-skills222—~1.1kAutomated safety check: PassMIT
Tanstack Routerbskimball/tanstack-hono119—~4.4kAutomated safety check: PassMIT
New React PlaygroundTanStack/ai3.2k—~266Automated safety check: NotesMIT

Similar skills

  • Walks through adding a Wagmi feature across its layers: a Viem-based core action, TanStack Query options, and React and Vue bindings.

    6.8k GitHub stars~3.8k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Cleanup Specialist

    ahaodev/shadmin

    Safe cleanup of Shadmin's Go backend, React frontend, Go CLI, and docs — remove dead code, consolidate duplication, and improve maintainability without changing behavior or adding features.

    174 GitHub stars~1.3k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Tanstack Router Best Practices

    DeckardGer/tanstack-agent-skills

    TanStack Router best practices for type-safe routing, data loading, search params, and navigation.

    222 GitHub stars~1.1k tokensUpdated 29 days ago
    DevelopmentAuto-check passed
  • Tanstack Router

    bskimball/tanstack-hono

    Type-safe routing for React and Solid applications with first-class search params, data loading, and seamless integration with the React ecosystem.

    119 GitHub stars~4.4k tokensUpdated 27 days ago
    DevelopmentAuto-check passed
  • A skill your agent uses when an agent in this TanStack AI monorepo needs a playground app to try a new feature.

    3.2k GitHub stars~266 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Tanstack Start

    secondsky/claude-skills

    TanStack Start (RC) full-stack React with server functions, SSR, Cloudflare Workers.

    227 GitHub stars~1.6k tokensUpdated 10 days ago
    DevelopmentAuto-check: notes

More from octanejs/octane

All 18 skills in this repo
  • Performance Audit

    octanejs/octane

    Audit or defend Octane performance. An agent skill from octanejs/octane.

    1.4k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Update Bindings

    octanejs/octane

    Audit one, several, or all existing Octane bindings; implement selected maintenance findings or remove redundant copied files with evidence matched to source ownership.

    1.4k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Handle Issue

    octanejs/octane

    Work a GitHub issue in the octane repo. An agent skill from octanejs/octane.

    1.4k GitHub stars~638 tokensUpdated yesterday
    Auto-check passed
  • Migrate V8 To V9

    octanejs/octane

    Perform a complete @tanstack/react-table v8-to-v9 migration: hook and feature architecture, row-model slots, React state and subscriptions, rendering, composable tables, type helpers, and every…

    1.4k GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • Implement and verify new React-library ports or copied/rewritten React surfaces in Octane bindings from npm names or npm/GitHub links/lists.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Triage

    octanejs/octane

    Work out which part of the octane monorepo owns an unfamiliar failure or task.

    1.4k GitHub stars~374 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about With Tanstack Query

What does With Tanstack Query do?

Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data. With Tanstack Query is an agent skill from octanejs/octane. Compose React Table v9 with TanStack Query for server filtering, sorting, pagination, and infinite data.

When should I use With Tanstack Query?

With Tanstack Query fits situations like: development work in your project.

How do I install With Tanstack Query in Claude Code?

Run `npx skills add octanejs/octane --skill with-tanstack-query -a claude-code`. Or copy the skill folder (packages/tanstack-table/upstream/skills/with-tanstack-query in octanejs/octane) into .claude/skills/with-tanstack-query in your project. Claude Code loads it when a task matches its description.

How do I install With Tanstack Query in Codex?

Run `npx skills add octanejs/octane --skill with-tanstack-query -a codex`. Or copy the skill folder (packages/tanstack-table/upstream/skills/with-tanstack-query in octanejs/octane) into .agents/skills/with-tanstack-query in your project. Codex loads it when a task matches its description.

Can I use With Tanstack Query in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add octanejs/octane --skill with-tanstack-query -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/with-tanstack-query, .gemini/skills/with-tanstack-query, .github/skills/with-tanstack-query and .opencode/skills/with-tanstack-query in your project.

What does With Tanstack Query need to run?

SKILL.md names no scripts, command-line tools or credentials: With Tanstack Query is instructions for the agent only.

Does With Tanstack Query access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is With Tanstack Query safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does With Tanstack Query use?

With Tanstack Query is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does With Tanstack Query use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to With Tanstack Query?

Skills that share tags, products or a category with With Tanstack Query: Wagmi Feature Development (wevm/wagmi, 6.8k stars), Cleanup Specialist (ahaodev/shadmin, 174 stars), Tanstack Router Best Practices (DeckardGer/tanstack-agent-skills, 222 stars) and Tanstack Router (bskimball/tanstack-hono, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains With Tanstack Query?

octanejs (a GitHub organization) maintains it in octanejs/octane, which has 1,450 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 8, 2026.

Source: octanejs/octane on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.