centrifugo — Claude Code skill: real-time PUB/SUB and WebSocket
Skill for working with Centrifugo, a self-hosted real-time messaging server supporting WebSocket, SSE, and GRPC. Sets up channels, JWT authentication, backend publishing, and client subscriptions to live updates.
no license 263 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill centrifugo -a claude-codeWhat centrifugo does
Centrifugo runs as an expert guide across all listed platforms for building real-time transport layers. The server receives data from your backend via HTTP or GRPC Server API and broadcasts to WebSocket, SSE, or WebTransport subscribers. Channels are organized into namespaces, each controlling its own behavior: message history retention, presence tracking, recovery after disconnection. Clients connect with a JWT token issued by the backend.
The skill covers server configuration (HMAC keys, CORS, TLS), channel structure design, token generation in Python or Node.js, publishing through Server API, and connecting official SDKs (JavaScript, Go, Dart, Swift, Java, Python). It handles unidirectional publishing (backend pushes updates to channels), bidirectional proxying (client events validated by backend), and server-side subscriptions for personalized feeds.
For multi-node clusters, Centrifugo uses Redis or NATS as a message broker between instances. The skill helps you pick an integration pattern, write configuration, set up authentication, and deploy your first real-time channel.
What it helps with
- deploy a self-hosted real-time server with WebSocket and SSE
- design channels with different history retention, presence, and recovery behavior
- issue JWT tokens for client connections from your backend
- publish messages to a channel via Server API and receive them on the client
- scale real-time updates across multiple servers using Redis or NATS
Example prompts for the agent
- Show me how to configure Centrifugo with Redis for a multi-node cluster and generate a JWT token for a client.
- Write an endpoint that publishes to a notification channel and a WebSocket subscriber that listens to it.
- Help me organize namespaces for a chat and live course feed with different history retention and TTL settings.
How to install centrifugo
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill centrifugo -a claude-code2Manually: put the files in place
~/.claude/skills/centrifugo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/centrifugo/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill centrifugo -a codex2Manually: put the files in place
.agents/skills/centrifugo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill centrifugo -a cursor2Manually: put the files in place
.cursor/skills/centrifugo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/curated/centrifugo2Manually: put the files in place
.github/skills/centrifugo/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill centrifugo -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/curated/centrifugoManually: put the files in place
.devin/skills/centrifugo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill centrifugo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about centrifugo
How do I install the centrifugo skill in Claude Code?
Run npx skills add pedronauck/skills --skill centrifugo -a claude-code, then find the skill file at ~/.claude/skills/centrifugo/SKILL.md.
What does the centrifugo skill do?
It guides you through setting up Centrifugo: a real-time messaging server with WebSocket support, channel management, JWT authentication, backend publishing, and client subscriptions to live updates.
Which transports does Centrifugo support?
WebSocket, Server-Sent Events (SSE), HTTP-streaming, WebTransport, and GRPC. The client automatically selects the best available transport and reconnects if the connection drops.