On this page

PubNub agent skills

The PubNub Skills Collection is a comprehensive set of skills for building real-time applications with PubNub's platform. Each skill provides focused guidance, code examples, and best practices for specific PubNub capabilities.

For example, you can ask your AI coding assistant to build a live auction app with real-time bidding and presence or add PubNub chat with typing indicators in plain English.

Who it's for and what it does

PubNub Skills are designed for anyone who wants to:

  • Build real-time PubNub applications using AI-assisted coding tools.
  • Apply production-ready patterns without deep SDK expertise.
  • Get guided architecture for channels, presence, Functions, App Context, and more.

Once installed, skills are automatically available in compatible AI coding assistants. Ask about PubNub topics and the relevant skill is invoked.

For live account access and API operations, set up the PubNub MCP Server. For a complete list of MCP tools your AI assistant can use with your PubNub account, refer to Available tools.

Skills, MCP Server, and docs — what to use when
  • PubNub Skills — focused guidance, code examples, and best practices for PubNub capabilities. Install once; your AI coding assistant applies them automatically.
  • MCP Server — live account access: create apps, manage keysets, publish messages, and query analytics in real time. Requires a PubNub account and IDE authorization.
  • PubNub docs — detailed API reference and how-to guides. Both Skills and the MCP Server surface docs to your AI assistant, but you can also browse them directly.

Skills are designed to work seamlessly with the PubNub MCP Server. For the fastest path from prompt to production, use both together.

Prerequisites

Before you begin, ensure you have:

  • A PubNub account — required to use the PubNub APIs and SDKs your AI will generate code for
  • One of the supported AI coding assistants:
    • Claude Code — skills load automatically from the project directory
    • Cursor IDE — skills are picked up via the .cursor/skills/ convention
    • VS Code with GitHub Copilot — compatible via the Vercel skills CLI
    • Codex and other agents that support the SKILL.md format

Install

Choose your installation method below. Once installed, PubNub Skills are automatically available to your AI coding assistant in the current project.

The skills CLI requires no installation and can be run directly using npx.

To install all 22 PubNub skills without any prompts:

npx skills add pubnub/skills --all

To choose specific skills or agents interactively, omit --all:

npx skills add pubnub/skills

For more details, see the Skills CLI reference.

Available skills

The collection includes 22 skills organized into four categories. Each skill links to its source in the PubNub Skills repo.

  • Core Platform — core platform capabilities that apply to all real-time apps
  • Platform Services — serverless compute, data storage, and integration services
  • Operations — reliability, observability, and platform management
  • Vertical — domain-specific guidance for common real-time application types

Core Platform skills

SkillSkill nameDescription
App developer
pubnub-app-developer
Core pub/sub messaging, channels, SDK patterns
Presence
pubnub-presence
Real-time user online/offline status, occupancy
Security
pubnub-security
Access Manager, AES-256 encryption, TLS
Chat
pubnub-chat
Chat SDK, messaging, typing indicators, reactions
App Context
pubnub-app-context
Objects API: users, channels, memberships, metadata

Platform Services skills

SkillSkill nameDescription
Functions
pubnub-functions
Serverless edge functions, webhooks, KVStore
History
pubnub-history
Storage & Playback, timetoken pagination, offline catch-up, dedup-on-merge
Events and Actions
pubnub-events-and-actions
Webhook / Lambda / Kafka / SQS / EventBridge integrations
Illuminate
pubnub-illuminate
Business Objects, Metrics, Decisions, Queries, Dashboards

Operations skills

SkillSkill nameDescription
Scale
pubnub-scale
High-volume optimization, channel groups, wildcard subscriptions
Reliability
pubnub-reliability
Backoff+jitter, idempotent publish, queue+retry, dedup, schema versioning
Observability
pubnub-observability
Logging correlation, test pyramid, runbooks, payload hygiene, usage metrics
Keyset management
pubnub-keyset-management
Apps, keysets, env separation, key hygiene, demo keys

Vertical skills

SkillSkill nameDescription
Live auctions
pubnub-live-auctions
Real-time auction platforms with bidding and countdowns
Live betting and casino
pubnub-live-betting-casino
Real-time betting and casino game platforms
Live sport updates
pubnub-live-sport-updates
Real-time sports scores, play-by-play, scoreboards
Live stock quote updates
pubnub-live-stock-quote-updates
Real-time stock quotes and market data
Live voting
pubnub-live-voting
Real-time voting and polling systems
Multiplayer gaming
pubnub-multiplayer-gaming
Real-time multiplayer game state synchronization
Order and delivery driver
pubnub-order-delivery-driver
Real-time order tracking and delivery driver systems
Telemedicine
pubnub-telemedicine
HIPAA-compliant telemedicine applications

Sample prompts

Once skills are installed, describe what you want to build in plain English. Your AI assistant applies the relevant PubNub skill automatically.

Create a live auction app using PubNub Skills. The app should include real-time bidding, bidder presence, auction countdown timers, bid history, and anti-sniping behavior where any bid placed in the last 10 seconds automatically extends the auction.
Build a multiplayer game lobby with real-time chat, player presence indicators, and team matchmaking using PubNub.
Create a HIPAA-compliant telehealth app with a virtual waiting room, secure patient-provider messaging, and WebRTC video consultation signaling.
Build a live sports scoreboard that shows real-time scores, play-by-play updates, and fan voting.
Create a real-time delivery tracking app with GPS location streaming from drivers and a customer-facing map.
Add PubNub presence to my existing app so users can see who else is online in each channel.