К основному содержанию
скилл CX Codex

trpc · oakoss — скилл для Claude Code: возможности и установка

trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами.

MIT 109 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill trpc -a claude-code
Открыть на GitHub

Что делает trpc

Скилл описывает работу с tRPC v11: настройку роутеров и процедур, проверку входных данных через Zod, middleware и контекст, подписки и обработку ошибок через TRPCError. Для React-клиента он охватывает хуки @trpc/react-query, а для серверных вызовов — createCallerFactory.

Также разобраны адаптеры для standalone, Express, Fastify и Hono, клиентские ссылки и тестирование процедур. В примерах есть передача типов через AppRouter без генерации кода. Публичный API для клиентов не на TypeScript не подходит для этого подхода: в таких случаях документация предлагает REST или GraphQL.

Какие задачи решает

  • Настроить роутер и типизированные процедуры tRPC
  • Проверить входные данные процедур через Zod
  • Подключить middleware и контекст запроса
  • Связать tRPC с React-клиентом
  • Протестировать процедуры и обработку ошибок

Примеры запросов агенту

  • Создай роутер tRPC v11 с процедурой для чтения профиля и проверкой входных данных через Zod.
  • Настрой middleware авторизации и передай пользователя через контекст процедур.
  • Подключи хуки @trpc/react-query к AppRouter и добавь тесты для процедур.

Как установить trpc

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill trpc -a claude-code

2Вручную: положить файлы

~/.claude/skills/trpc/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/trpc/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о trpc

Как установить trpc в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill trpc -a claude-code. Файл скилла появится по пути ~/.claude/skills/trpc/SKILL.md.

Что делает trpc?

Скилл помогает собирать типобезопасные API на TypeScript с tRPC v11: от роутеров и валидации до React-клиента, адаптеров и тестов.

Подходит ли trpc для публичного API, которым пользуются клиенты не на TypeScript?

Описанный подход рассчитан на обмен TypeScript-типами между сервером и клиентом. Для публичных API с клиентами не на TypeScript в документации рекомендуются REST или GraphQL.

Исходный текст

SKILL.md · MIT
---
name: trpc
description: |
  tRPC v11 end-to-end type-safe APIs for TypeScript. Covers router and procedure definitions, input validation with Zod, middleware and context, subscriptions, error handling with TRPCError, React client hooks via @trpc/react-query, server-side callers with createCallerFactory, adapter setup (standalone, Express, Fastify, Hono), and testing patterns.

  Use when building tRPC routers, defining procedures, setting up middleware, configuring adapters, integrating tRPC with React, handling errors, implementing subscriptions, or testing tRPC procedures.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://trpc.io/docs'
user-invocable: false
---

# tRPC

## Overview

tRPC enables end-to-end type-safe APIs by sharing TypeScript types between server and client without code generation or schemas. The server defines procedures (queries, mutations, subscriptions) in a router, and the client infers all types from the exported `AppRouter` type.

**When to use:** TypeScript full-stack apps needing type-safe API layers, monorepos sharing types, real-time subscriptions, rapid API iteration without OpenAPI/GraphQL overhead.

**When NOT to use:** Public APIs consumed by non-TypeScript clients (use REST/GraphQL), polyglot backends, projects requiring OpenAPI spec generation as primary output.

## Quick Reference

| Pattern               | API                                        | Key Points                                              |
| --------------------- | ------------------------------------------ | ------------------------------------------------------- |
| Initialize            | `initTRPC.context<Ctx>().create()`         | Single entry point, configure once                      |
| Router                | `t.router({ ... })`                        | Nest routers with `t.mergeRouters()`                    |
| Query                 | `t.procedure.input(schema).query(fn)`      | Read operations, cached by clients                      |
| Mutation              | `t.procedure.input(schema).mutation(fn)`   | Write operations                                        |
| Subscription          | `t.procedure.subscription(fn)`             | Real-time via WebSocket or SSE                          |
| Middleware            | `t.middleware(fn)`                         | Chain with `.use()`, extend context via `next({ ctx })` |
| Standalone middleware | `experimental_standaloneMiddleware<{}>()`  | Reusable with explicit type constraints                 |
| Context               | `createContext({ req, res })`              | Per-request, passed to all procedures                   |
| Server caller         | `t.createCallerFactory(router)`            | Type-safe server-side procedure calls                   |
| Error                 | `throw new TRPCError({ code, message })`   | Mapped to HTTP status codes                             |
| Error formatter       | `initTRPC.create({ errorFormatter })`      | Customize error shape, expose Zod errors                |
| Input validation      | `.input(zodSchema)`                        | Multiple `.input()` calls merge (intersection)          |
| Output validation     | `.output(zodSchema)`                       | Strip extra fields from responses                       |
| React hooks           | `trpc.useQuery()` / `trpc.useMutation()`   | Built on @tanstack/react-query                          |
| React utils           | `trpc.useUtils()`                          | Invalidate, prefetch, setData on cache                  |
| Suspense query        | `trpc.useSuspenseQuery()`                  | Suspense-compatible data fetching                       |
| React subscription    | `trpc.useSubscription(input, opts)`        | `onData` callback for real-time events                  |
| Vanilla client        | `createTRPCClient<AppRouter>({ links })`   | No React dependency                                     |
| Batch link            | `httpBatchLink({ url })`                   | Batches requests in single HTTP call                    |
| Stream link           | `httpBatchStreamLink({ url })`             | Streams responses as they resolve                       |
| WS link               | `wsLink({ client: wsClient })`             | WebSocket transport for subscriptions                   |
| Split link            | `splitLink({ condition, true, false })`    | Route operations to different transports                |
| Logger link           | `loggerLink()`                             | Debug request/response in development                   |
| Data transformer      | `initTRPC.create({ transformer })`         | Serialize Dates, Maps, Sets (superjson)                 |
| Fetch adapter         | `fetchRequestHandler({ endpoint, req })`   | Cloudflare Workers, Deno, Bun, Next.js                  |
| Procedure chaining    | `publicProcedure.use(auth).use(rateLimit)` | Build reusable procedure bases                          |

## Common Mistakes

| Mistake                                             | Correct Pattern                                                                |
| --------------------------------------------------- | ------------------------------------------------------------------------------ |
| Exporting the full `t` object                       | Export only `t.router`, `t.procedure`, `t.middleware`, `t.createCallerFactory` |
| Creating context inside procedure                   | Create context in adapter setup, flows through automatically                   |
| Using `any` for context type                        | Define context type with `initTRPC.context<MyContext>().create()`              |
| Catching errors in procedures                       | Let errors propagate; use `onError` in adapter or error formatter              |
| Importing server code on client                     | Import only `type AppRouter`, never runtime server code                        |
| Using `createCaller` in production request handlers | Use `createCallerFactory` for type-safe reusable callers                       |
| Defining input without validation                   | Always validate with Zod, Valibot, or ArkType schemas                          |
| Nesting routers incorrectly                         | Use dot notation in keys or `t.mergeRouters()`, not deep nesting               |
| Different transformers on client/server             | Both sides must use the same transformer (e.g., superjson)                     |
| Creating QueryClient inside component render        | Create once outside component or use useState initializer                      |
| Manual TypeScript generics on hooks                 | Type the router procedures; let inference propagate to client                  |
| Not passing `signal` to fetch in queryFn            | tRPC React handles abort signals automatically                                 |

## Installation

```bash
pnpm add @trpc/server @trpc/client @trpc/react-query @tanstack/react-query zod
```

For subscriptions, add `ws` (server) and configure `wsLink` (client). For SSE-based subscriptions, use `httpBatchStreamLink` instead.

## Delegation

- **Procedure discovery**: Use `Explore` agent
- **Router architecture review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent

> If the `tanstack-query` skill is available, delegate query/mutation caching, invalidation, and optimistic update patterns to it.
> If the `zod-validation` skill is available, delegate input schema design and validation patterns to it.
> If the `drizzle-orm` skill is available, delegate database query patterns within procedures to it.
> If the `vitest-testing` skill is available, delegate test runner configuration and assertion patterns to it.
> If the `hono` skill is available, delegate Hono framework routing and middleware patterns to it.

## References

- [Router and procedure definitions](references/router-procedures.md)
- [Middleware and context patterns](references/middleware-context.md)
- [Error handling and formatting](references/error-handling.md)
- [React client integration with @trpc/react-query](references/react-integration.md)
- [Server-side callers and vanilla client](references/server-callers.md)
- [Adapter setup for standalone, Express, Fastify, and Hono](references/adapter-setup.md)
- [Subscriptions and real-time patterns](references/subscriptions.md)
- [Testing tRPC procedures](references/testing-patterns.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — trpc от других авторов.

trpc Mindrally Скилл trpc для Claude Code помогает писать приложения Next.js с типобезопасными API на tRPC v11. Он подключается к задачам по настройке серверной и клиентской частей, роутеров и процедур. CX Codex +1 911установок trpc bobmatnyc Скилл trpc для Claude Code помогает создавать типобезопасные API на TypeScript с интеграцией React Query. Подключается при работе с tRPC и связанными задачами. CX Codex +1 259установок trpc-expert 0xfurai Субагент trpc-expert для Claude Code пишет бэкенд на tRPC: собирает роутеры, типы и middleware. Работает с расхождениями типов сервера и клиента. CX Codex ★ 1 029звёзд репо nodejs-backend bobmatnyc Скилл nodejs-backend для Claude Code помогает собирать серверную часть на TypeScript с Express или Fastify. Включает работу с REST API, маршрутами, middleware и подключением базы данных. CX Codex +1 307установок orval pproenca Набор из 42 правил для генерации типизированных клиентов TypeScript из OpenAPI через Orval. Помогает настроить конфигурацию, хуки запросов и моки MSW. CX Codex +1 347установок deno-typescript Mindrally Скилл deno-typescript с правилами разработки на Deno и TypeScript: архитектура проекта, встроенные инструменты, модель разрешений и работа с Deno KV или Hono. CX Codex +1 801установок bun-hono-integration secondsky Скилл bun-hono-integration для Claude Code и Codex подсказывает агенту, как строить API на Hono под Bun: маршруты, middleware, валидация через Zod, RPC-клиент. Работает в проектах, уже запущенных на Bun. CX Codex +1 473установок hono-validation bobmatnyc Скилл hono-validation для Claude Code и Cursor: валидирует JSON, формы, query-параметры, заголовки и cookie в Hono. Типы из схемы доступны прямо в обработчике. CX Codex +1 427установок

Из того же набора106

Весь набор →
hono Скилл по веб-фреймворку Hono для создания API и edge-функций на Cloudflare Workers, Bun, Deno и Node.js. CX Codex +1 112установок astro Скилл Claude Code объясняет агенту Astro: коллекции контента, островную гидратацию, view transitions и режимы рендеринга. Описывает статичные сайты с вкраплениями интерактива. CX Codex +1 111установок db-enforcer Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS. CX Codex +1 109установок electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок tauri Помогает собирать приложения на Tauri v2 с веб-интерфейсом и бэкендом на Rust. Подключается при настройке проекта, IPC, разрешений или выпуска приложения. CX Codex +1 108установок turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой