Agent skill

Trpc

by pproenca in pproenca/dot-skills

Corrects the wrong defaults a model has for tRPC v11 (verified against 11.18.0).

MITAuto-check passedBackend & APIs

Install Trpc

skills CLI
$ npx skills add pproenca/dot-skills --skill trpc -a claude-code

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

GitHub CLI
$ gh skill install pproenca/dot-skills trpc --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/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/trpc .claude/skills/trpc && 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
trpc
GitHub stars
214
Token cost
~2.8k tokens
SKILL.md length
965 words
Files
38 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

Corrects the wrong defaults a model has for tRPC v11 (verified against 11.18.0).

  • Works in 7 steps: React Client Surface → v10 → v11 Drift → Router & Procedure Construction → …
  • Code imports initTRPC
  • SKILL.md covers When to Apply, Rule Categories, Quick Reference and How to Use, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trpc is an agent skill from pproenca/dot-skills. Corrects the wrong defaults a model has for tRPC v11 (verified against 11.18.0). Use when code imports initTRPC, createTRPCContext, createTRPCOptionsProxy, createTRPCReact, httpBatchLink, httpSubscriptionLink, fetchRequestHandler, or TRPCError, or when building routers, procedures, middleware, links, or RSC prefetching. Covers the v10 to v11 drift that makes stale code fail — the React client that flipped to @trpc/tanstack-react-query, transformers moving into links, renamed type exports, observable subscriptions…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 40 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).

It sits in Backend & APIs, covering gRPC and Protobuf and Forms and validation. It works with TanStack, tRPC, Next.js and Zod. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Code imports initTRPC
  • CreateTRPCContext
  • CreateTRPCOptionsProxy
  • CreateTRPCReact

Example prompts

  • “Use the trpc skill to correct the wrong defaults a model has for tRPC v11 (verified against 11.18.0)”
  • “/trpc”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. React Client Surface
  2. v10 → v11 Drift
  3. Router & Procedure Construction
  4. Error & Validation Semantics
  5. Links, Transport & Serialization
  6. SSR, RSC & Server-Side Calls
  7. Subscriptions & Streaming

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. 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.

    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

Trpc loads about 2.8k tokens when it runs, and up to ~23k if it reads all its reference files. Until then it costs about 233 tokens; SKILL.md has 965 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~233
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~23k

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 pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 965 words, ~2,762 tokens.

Download SKILL.mdSave it as .claude/skills/trpc/SKILL.md (or your agent's skills folder). This skill also uses 37 other files; get the full folder from GitHub.
name
trpc
description
Corrects the wrong defaults a model has for tRPC v11 (verified against 11.18.0). Use when code imports initTRPC, createTRPCContext, createTRPCOptionsProxy, createTRPCReact, httpBatchLink, httpSubscriptionLink, fetchRequestHandler, or TRPCError, or when building routers, procedures, middleware, links, or RSC prefetching. Covers the v10 to v11 drift that makes stale code fail — the React client that flipped to @trpc/tanstack-react-query, transformers moving into links, renamed type exports, observable subscriptions replaced by async generators over SSE — plus the defaults that are unsafe rather than merely stale — uncapped batching, CDN cache headers that serve one user's data to another, stack traces shipped from edge runtimes, and middleware that runs before input validation. NOT for TanStack Query semantics generally (use tanstack-query), Zod schema authoring (use zod), or Next.js App Router routing (use nextjs).

tRPC v11

The decisions tRPC forces and how to settle them, written so an agent applies them while writing or reviewing code. Every rule names the wrong default it corrects; there is no rule for what the model already gets right.

Pinned to tRPC v11, verified against 11.18.0 (2026-06-17). There is no v12 — but several APIs here carry @deprecated … will be removed in v12 and still ship today. Peers: typescript >=5.7.2, @tanstack/react-query ^5.80.3, react >=18.2.0.

When to Apply

Use this skill when:

  • Code imports initTRPC, createTRPCContext, createTRPCOptionsProxy, createTRPCReact, createTRPCClient, httpBatchLink, httpSubscriptionLink, splitLink, fetchRequestHandler, createCallerFactory, or TRPCError — or defines procedures with .input() / .output() / .use() / .query() / .mutation() / .subscription()
  • The user says "everything types as any", "invalidation isn't working", "contextMap[utilName] is not a function", "the transformer property moved", "414 / 413 on the dashboard", "subscriptions won't connect", "the prefetch isn't hydrating", or "it 404s every procedure"
  • Migrating a codebase from tRPC v10, or reviewing tRPC code written against v10-era examples — the highest-yield moment, because the recommended React client changed and stale code often still compiles
  • Adding the first subscription, the first file upload, or the first RSC prefetch to an existing router — each crosses into a surface where v11 replaced the v10 approach outright
  • Reviewing a batched client as the app grows, where the uncapped defaults turn into intermittent production failures

This skill is NOT for:

  • General TanStack Query semantics — cache lifetimes, retry, useMutation ergonomics (→ tanstack-query)
  • Authoring or migrating the Zod schemas used as validators (→ zod)
  • Next.js App Router routing, streaming, or caching beyond the tRPC handler (→ nextjs)
  • General TypeScript narrowing and generics (→ typescript)

Rule Categories

#CategoryPrefixCovers
1React Client Surfaceclient-Which integration, options factories, query keys, invalidation, subscribing
2v10 → v11 Driftmig-Renamed, removed, and lazily-materialized APIs; peer-version floors
3Router & Procedure Constructionproc-Instance identity, builder order, context narrowing, input merging
4Error & Validation Semanticserr-What surfaces, what leaks, which error class
5Links, Transport & Serializationlink-Link chain, batching limits, transformers, adapters, caching
6SSR, RSC & Server-Side Callsrsc-Prefetch and hydration, QueryClient lifetime, caller misuse
7Subscriptions & Streamingsub-Async generators over SSE, auth, keepalive, backlog races

Quick Reference

1. React Client Surface
2. v10 → v11 Drift
3. Router & Procedure Construction
4. Error & Validation Semantics
  • err-format-standard-schema-issues — Parser dispatch is ordered, so a Zod-only errorFormatter returns null for Valibot / Effect (StandardSchemaV1Error) and for ArkType (ArkErrors)
  • err-output-strips-fields — .output() returns the parsed value, so it strips unknown keys; its failure is a 500, not a 4xx
  • err-nullish-cursor — .optional() cursors 400 only after an invalidate; use .nullish()
  • err-set-isdev-explicitly — Without an explicit isDev, edge runtimes ship error.data.stack to every client
Show full SKILL.md (372 more words)Show less
6. SSR, RSC & Server-Side Calls
7. Subscriptions & Streaming

How to Use

Read a reference file when its decision comes up. Each rule names the wrong default it corrects, then shows the canonical way — with an incorrect/correct contrast only where the wrong way is a real trap.

Two shortcuts worth taking first:

  • Reviewing or migrating existing tRPC code? Start with client- and mig-. Stale code frequently still compiles, so nothing points you at these; they are what everything else inherits.

  • Hardening something already working? The security-shaped rules are link-gate-cache-headers, rsc-query-client-per-request, err-set-isdev-explicitly, proc-input-before-use, and sub-keep-credentials-out-of-urls.

  • Section definitions — category structure and ordering rationale

  • Rule template — for adding new rules

  • AGENTS.md — auto-built table of contents across all rules

  • tanstack-query — The query layer tRPC's React client now delegates to; owns cache semantics this skill assumes
  • zod — Validator authoring and Zod 4 drift, including the .flatten() → z.treeifyError() change this skill only points at
  • typescript — General type-level work beyond tRPC's inference surface

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

Files

SKILL.md and 37 other files (references, assets) in skills/.experimental/trpc of pproenca/dot-skills.

  • SKILL.md
  • AGENTS.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/client-derive-query-keys.md
  • references/client-invalidate-with-query-filters.md
  • references/client-subscription-options.md
  • references/client-tanstack-integration.md
  • references/err-format-standard-schema-issues.md
  • references/err-nullish-cursor.md
  • references/err-output-strips-fields.md
  • references/err-set-isdev-explicitly.md
  • references/link-cap-batch-size.md
  • references/link-default-to-httpbatchlink.md
  • references/link-endpoint-matches-mount-path.md
  • references/link-gate-cache-headers.md
  • references/link-read-batch-headers-from-oplist.md
  • … and 20 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

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

Trpc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trpc this skillpproenca/dot-skills214—~2.8kAutomated safety check: PassMIT
Olore Trpc Latestolorehq/olore103—~1kAutomated safety check: PassMIT
Olore Tanstack Form Latestolorehq/olore103—~1.1kAutomated safety check: PassMIT
Backend Dev Guidelineslitefuse/litefuse1001 repos~5.8kAutomated safety check: PassCustom licence
Nestjs Trpctrycompai/crm11k—~2.8kAutomated safety check: PassMIT
Backend Dev Guidelineslangfuse/langfuse35k—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Olore Trpc Latest

    olorehq/olore

    Local tRPC documentation reference (latest). An agent skill from olorehq/olore.

    103 GitHub stars~1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Local TanStack Form documentation reference (latest, v1.33.5).

    103 GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed
  • Backend Dev Guidelines

    litefuse/litefuse

    Comprehensive backend development guide for Litefuse's Next.js 14/tRPC/Express/TypeScript monorepo.

    100 GitHub starsUsed in 1 repo~5.8k tokens
    Backend & APIsAuto-check passed
  • Nestjs Trpc

    trycompai/crm

    Build end-to-end type-safe tRPC APIs inside NestJS using the nestjs-trpc adapter — @Router/@Query/@Mutation/@Subscription decorators, TRPCModule.forRoot, injectable middlewares and context, Zod…

    11k GitHub stars~2.8k tokensUpdated 26 days ago
    Backend & APIsAuto-check passed
  • Backend Dev Guidelines

    langfuse/langfuse

    Build or review Langfuse backend code. An agent skill from langfuse/langfuse.

    35k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Buzzform

    buildnbuzz/buzzform

    A skill your agent uses when working with BuzzForm schema-driven forms, @buildnbuzz/form-core, @buildnbuzz/form-react, or any related APIs like defineSchema, InferType, FormProvider, useDataField…

    101 GitHub stars~1.5k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Trpc

What does Trpc do?

Corrects the wrong defaults a model has for tRPC v11 (verified against 11.18.0). Trpc is an agent skill from pproenca/dot-skills.0).

When should I use Trpc?

Trpc fits situations like: code imports initTRPC; createTRPCContext; createTRPCOptionsProxy; createTRPCReact.

How do I install Trpc in Claude Code?

Run `npx skills add pproenca/dot-skills --skill trpc -a claude-code`. Or copy the skill folder (skills/.experimental/trpc in pproenca/dot-skills) into .claude/skills/trpc in your project. Claude Code loads it when a task matches its description.

How do I install Trpc in Codex?

Run `npx skills add pproenca/dot-skills --skill trpc -a codex`. Or copy the skill folder (skills/.experimental/trpc in pproenca/dot-skills) into .agents/skills/trpc in your project. Codex loads it when a task matches its description.

Can I use Trpc 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 pproenca/dot-skills --skill trpc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trpc, .gemini/skills/trpc, .github/skills/trpc and .opencode/skills/trpc in your project.

What does Trpc need to run?

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

Does Trpc 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 Trpc 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 Trpc use?

Trpc 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 Trpc use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 20k tokens, read only when the agent opens those files.

What are the alternatives to Trpc?

Skills that share tags, products or a category with Trpc: Olore Trpc Latest (olorehq/olore, 103 stars), Olore Tanstack Form Latest (olorehq/olore, 103 stars), Backend Dev Guidelines (litefuse/litefuse, 100 stars) and Nestjs Trpc (trycompai/crm, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trpc?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

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