Skip to content

secondsky/claude-skills / plugins/tanstack-ai/skills/tanstack-ai

tanstack-ai

Verified

TanStack 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.

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.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall