fishjam-platform

Define the Fishjam platform domain model and authentication flow.

265|12|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/software-mansion-labs/skills --skill fishjam-platform
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fishjam-platform
Source: https://github.com/software-mansion-labs/skills/tree/main/skills/fishjam/references/platform
Command: npx skills add https://github.com/software-mansion-labs/skills --skill fishjam-platform

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a single source of truth for the Fishjam platform's domain model and authentication flow, unifying how rooms, tokens, and notifications are understood across all SDKs to enable consistent, scalable integrations.

Core Features & Use Cases

  • Domain model and authentication: Core concepts like Room, Peer, Track, Streamer, and Viewer, plus the two-tier token system (management vs peer) and the end-to-end join flow.
  • Room types and notifier options: Covers conference, audio_only, livestream, and audio_only_livestream, with WebSocket and webhook notifier options and the associated event taxonomy.
  • OpenAPI and docs alignment: References to REST (OpenAPI) and protobuf-based notifications to ensure integration alignment across SDKs and backends.

Quick Start

Read this guide to understand the platform fundamentals before building your Fishjam integration.

Frequently Asked Questions about fishjam-platform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does Fishjam platform authentication work for SDK integrations?

Fishjam platform authentication uses a two-tier token system: management tokens for governance and peer tokens for end-to-end join flow access, ensuring secure SDK connections.

What room types does the Fishjam domain model support?

The Fishjam domain model supports four room types: conference, audio_only, livestream, and audio_only_livestream, each defining specific Peer, Track, and Streamer behaviors.

How do I configure WebSocket vs webhook notifiers in Fishjam?

Fishjam notifiers can be configured using either WebSocket or webhook options, each providing a distinct event taxonomy for receiving platform updates during room operations.

When should I use sandbox vs production environments in Fishjam?

Fishjam sandbox environments are used for development and testing integrations, while production environments handle live traffic, with token lifetimes and governance rules adjusted per environment.

Does the Fishjam platform provide OpenAPI and protobuf specs?

Yes, the Fishjam platform provides REST endpoints via OpenAPI specs and notification structures via protobuf, ensuring integration alignment across various SDKs and backends.

What is the end-to-end join flow for a Fishjam peer?

The Fishjam end-to-end join flow involves obtaining a peer token, connecting to the specified room type, and establishing tracks, managed securely via the platform's unified domain model.