Agent skill

Centrifugo

by pedronauck in pedronauck/skills

Centrifugo real-time messaging server expert for WebSocket PUB/SUB, channel management, JWT authentication, event proxying, and horizontal scaling with Redis/NATS.

No licenceAuto-check passedBackend & APIs

Install Centrifugo

skills CLI
$ npx skills add pedronauck/skills --skill centrifugo -a claude-code

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

GitHub CLI
$ gh skill install pedronauck/skills centrifugo --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/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/curated/centrifugo .claude/skills/centrifugo && 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
centrifugo
GitHub stars
634
Token cost
~3.1k tokens
SKILL.md length
964 words
Files
8 (incl. references)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Centrifugo real-time messaging server expert for WebSocket PUB/SUB, channel management, JWT authentication, event proxying, and horizontal scaling with Redis/NATS.

  • Works in 10 steps: Determine Integration Pattern → Configure Centrifugo Server → Set Up Authentication → …
  • Real-time messaging
  • SKILL.md covers Core Architecture, Procedures, Anti-Patterns and Error Handling, plus 1 more section
  • Calls curl, docker and npm; needs API_KEY and HMAC_SECRET

What it does

Centrifugo is an agent skill from pedronauck/skills. Centrifugo real-time messaging server expert for WebSocket PUB/SUB, channel management, JWT authentication, event proxying, and horizontal scaling with Redis/NATS. Use when: centrifugo, centrifugal, real-time messaging, websocket pubsub, channel subscriptions, real-time notifications, live updates, presence, history recovery, server-sent events integration, real-time transport layer. Do not use for: general WebSocket programming without Centrifugo, Socket.IO, Pusher SDK, or other real-time frameworks.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/authentication.md`, `references/channels.md` and `references/client-sdk.md`).

It sits in Backend & APIs, covering Realtime and WebSockets, Authentication and Event-driven systems. It works with Redis. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Real-time messaging
  • Websocket pubsub
  • Channel subscriptions
  • Real-time notifications

Example prompts

  • “/centrifugo”

Requirements

  • Python 3
  • Node.js
  • Docker
  • A credential in API_KEY
  • A credential in HMAC_SECRET

Workflow steps

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

  1. Determine Integration Pattern
  2. Configure Centrifugo Server
  3. Set Up Authentication
  4. Design Channel Structure
  5. Publish from Backend (Server API)
  6. Connect Clients with SDK
  7. Configure Event Proxy (Optional)
  8. Scale Horizontally (Production)
  9. Enable History and Recovery
  10. Add Observability

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • curl
    • docker
    • npm
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, docker and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY
    • HMAC_SECRET
    • JWT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Centrifugo loads about 3.1k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 964 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 964 words (~3,091 tokens).

“Centrifugo is a self-hosted, language-agnostic real-time messaging server. It handles persistent connections (WebSocket, SSE, HTTP-streaming, WebTransport, GRPC) and broadcasts messages via a channel-based PUB/SUB model. The application backend publishes to channels via Server API; Centrifugo delivers to online subscribers instantly.”

— opening of SKILL.md by pedronauck
name
centrifugo

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (references) in skills/curated/centrifugo of pedronauck/skills.

  • SKILL.md
  • references/authentication.md
  • references/channels.md
  • references/client-sdk.md
  • references/configuration.md
  • references/engines.md
  • references/proxy.md
  • references/server-api.md

Open the folder on GitHubat commit 0422940

Compare with similar skills

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

Centrifugo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Centrifugo this skillpedronauck/skills634—~3.1kAutomated safety check: PassNone
Cb Realtime APIBlkLeg/CircuitBreaker201—~1.7kAutomated safety check: PassMIT
Ak Cloud Deployyaalalabs/agent-kernel192—~14kAutomated safety check: PassApache-2.0
Supabase Development and Debuggingsupabase/agent-skills2.7k3 repos~3.6kAutomated safety check: PassMIT
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
Gemini Live API Devgoogle-gemini/gemini-skills4.3k—~4.6kAutomated safety check: PassApache-2.0

Similar skills

  • Cb Realtime API

    BlkLeg/CircuitBreaker

    How Circuit Breaker moves data between backend and frontend — the NATS internal bus, Redis pub/sub, the WebSocket stream endpoints and their first-message JWT handshake, SSE log/event streams, and…

    201 GitHub stars~1.7k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Ak Cloud Deploy

    yaalalabs/agent-kernel

    Deploy an Agent Kernel project to AWS, Azure, or GCP using Terraform modules, or to any Kubernetes cluster (on-prem, baremetal, EKS) using the official Helm chart.

    192 GitHub stars~14k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Official

    General Supabase skill for database, auth, Edge Functions, Realtime and storage work, plus client libraries, migrations, security audits, debugging and reading logs.

    2.7k GitHub starsUsed in 3 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes
  • Gemini Live API Dev

    google-gemini/gemini-skills

    Official

    A skill your agent uses when building real-time, bidirectional streaming applications with the Gemini Live API, or migrating legacy Live models (2.0/2.5/3.1) to Gemini 3.8 Live.

    4.3k GitHub stars~4.6k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 26 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 26 days ago
    Auto-check passed

Works with

Categories

Questions about Centrifugo

What does Centrifugo do?

Centrifugo real-time messaging server expert for WebSocket PUB/SUB, channel management, JWT authentication, event proxying, and horizontal scaling with Redis/NATS. Centrifugo is an agent skill from pedronauck/skills. Centrifugo real-time messaging server expert for WebSocket PUB/SUB, channel management, JWT authentication, event proxying, and horizontal scaling with Redis/NATS.

When should I use Centrifugo?

Centrifugo fits situations like: real-time messaging; websocket pubsub; channel subscriptions; real-time notifications.

How do I install Centrifugo in Claude Code?

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

How do I install Centrifugo in Codex?

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

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

What does Centrifugo need to run?

Going by SKILL.md and its folder, Centrifugo needs the command-line tools its instructions call (curl, docker, npm and bun) and credentials named API_KEY, HMAC_SECRET and JWT_TOKEN. Our summary lists: Python 3; Node.js; Docker; A credential in API_KEY; A credential in HMAC_SECRET.

Does Centrifugo access the network?

SKILL.md contains no URLs. Its commands use curl, docker and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Centrifugo 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 Centrifugo use?

No licence was found for Centrifugo or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Centrifugo use?

About 3.1k tokens (SKILL.md is roughly 12k 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 10k tokens, read only when the agent opens those files.

What are the alternatives to Centrifugo?

Skills that share tags, products or a category with Centrifugo: Cb Realtime API (BlkLeg/CircuitBreaker, 201 stars), Ak Cloud Deploy (yaalalabs/agent-kernel, 192 stars), Supabase Development and Debugging (supabase/agent-skills, 2.7k stars) and Stripe Projects (fossasia/eventyay, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Centrifugo?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

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