setup-connect-query

Installation
SKILL.md

Setup Connect Query

What This Sets Up

PostToolUse hook on Edit/Write catching data-fetching anti-patterns across the ConnectRPC + TanStack Query + Protobuf stack:

  • Ban raw useQuery/useMutation from @tanstack/react-query when file uses ConnectRPC — must use Connect Query (exception: files importing from @connectrpc/connect directly for useTransport/callUnaryMethod pattern)
  • Ban invalidateQueries() with no args — must specify query key
  • Warn on axios imports — prefer ConnectRPC transport
  • Warn on fetch() calls — prefer ConnectRPC transport
  • Protobuf v2 only: Ban new Message() construction — use create(Schema)
  • Protobuf v2 only: Ban PlainMessage/PartialMessage — use MessageShape/MessageInitShape
  • Protobuf v2 only: Ban manual object literals with $typeName — use create(Schema) for type-safe construction

Escape hatch: // allow-direct-query: [reason] for legitimate REST endpoints.

Steps

1. Detect protobuf version

Related skills
Installs
8
GitHub Stars
3
First Seen
Mar 25, 2026