secondsky/claude-skills / plugins/tanstack-ai/skills/tanstack-ai
tanstack-ai
VerifiedTanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama. Use for chat APIs, React/Solid frontends with useChat/ChatClient, isomorphic tools, tool approval flows, agent loops, multimodal inputs, or troubleshooting streaming and tool definitions.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.4 KB |
| assets/api-chat-route.ts | script | 859 B |
| assets/tool-definitions.ts | script | 1.0 KB |
| references/adapter-matrix.md | markdown | 2.4 KB |
| references/react-integration.md | markdown | 1.5 KB |
| references/start-vs-next-routing.md | markdown | 1.8 KB |
| references/streaming-troubleshooting.md | markdown | 2.2 KB |
| references/tanstack-ai-cheatsheet.md | markdown | 2.4 KB |
| references/tool-patterns.md | markdown | 2.0 KB |
| references/type-safety.md | markdown | 1.5 KB |
| scripts/check-ai-env.shexecutable | script | 512 B |
references/tool-patterns.md
View on GitHub# Tool Patterns (TanStack AI)
## 1) Server-only tool (data fetch)
```ts
const getUserDef = toolDefinition({...})
export const getUser = getUserDef.server(async ({ id }) => db.user.find(id))
// Pass getUser in server tools array
```
Use for: DB/API reads, writes that must stay server-side.
## 2) Client-only tool (UI mutation)
```ts
const highlightDef = toolDefinition({...})
export const highlight = highlightDef.client(({ id }) => {
document.querySelector(`#row-${id}`)?.classList.add('ring')
return { highlighted: true }
})
```
Use for: UI updates, notifications, clipboard, local storage.
## 3) Hybrid (server fetch → client update)
```ts
const getUserDef = toolDefinition({...})
export const getUser = getUserDef.server(/* fetch */)
export const showUser = getUserDef.client(/* render or focus */)
// include both in tools
```
Use for: fetch data then update UI within one agent loop.
## 4) Long-running tool with polling
```ts
export const startJob = jobDef.server(async () => {
const jobId = await queue.enqueue()
return { jobId, pollAfterMs: 2000 }
})
```
Model can call the tool again after `pollAfterMs` to check status; cap with `agentLoopStrategy`.
## 5) Approval-gated tool
```ts
const deleteDef = toolDefinition({ needsApproval: true, ... })
export const deleteUser = deleteDef.server(/* destructive op */)
// UI shows approval.pending and calls approval.approve()
```
Use for: billing, deletes, external side effects.
## 6) Error-handling pattern
Return structured errors instead of throw:
```ts
return { error: { type: 'NotFound', message: 'User missing' } }
```
Model can summarize or retry; avoids unhandled stream errors.
## 7) Input validation
Always add Zod schemas on inputs and normalize outputs. Reject early with helpful messages.
## 8) Naming consistency
Tool name in `toolDefinition` must match client/server implementations exactly to avoid “tool not found.”
## 9) Observability hooks
Wrap tool implementations to log duration, input size, and approval status; redact secrets before logging.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |