# doca-rmax

doca-rmax — a skill for debugging precision-timed media stream reception (SMPTE ST 2110, market data, scientific feeds) on BlueField DPU via DOCA Rivermax. Helps when packets don't arrive, jitter spikes, or license validation fails.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 4106 repo stars
- Author: NVIDIA
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-rmax/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/doca-rmax

## What it does

doca-rmax serves developers working with Rivermax apps that run exclusively on BlueField DPU. The skill covers stream object setup (`doca_rmax_in_stream`), precondition checks (Rivermax SDK and license installed separately), capability queries (`doca_rmax_get_*_supported`), pairing with `doca-eth` queues and `doca-flow` steering, and error diagnosis from `DOCA_ERROR_*` calls.

For the skill to work, Rivermax libraries (`doca-sdk-rmax`) and a valid license must already be installed on the target DPU—this is separate from DOCA and requires a distinct installation path. The skill declines to help with queue programming (handled by `doca-eth`), steering rules (`doca-flow`), clock sync (`doca-firefly`), or plain packet I/O.

Trigger the skill on phrases like "ST 2110 receive gets no frames", "sub-microsecond jitter on the receiver", "NOT_SUPPORTED from doca_rmax_init", or "license check failing"—even without explicitly naming Rivermax.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-rmax -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/doca-rmax/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/doca-rmax/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-rmax -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/doca-rmax/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-rmax -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/doca-rmax/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skills/doca-rmax
```

2. **Manually: put the files in place**
- File: `.github/skills/doca-rmax/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-rmax -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/doca-rmax
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/doca-rmax/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-rmax/SKILL.md

## When to use it
- diagnose why a Rivermax stream stops receiving packets
- check if device supports the needed receive mode (PTP, packet placement)
- decode NOT_SUPPORTED or other DOCA_ERROR_* from init
- configure a receive session for SMPTE ST 2110 video or audio on DPU
- verify Rivermax SDK and license are present before first run

## Example prompts
- My Rivermax stream starts but recv events never fire—help me debug
- Does this hardware support ST 2110-20 with sequence-number placement?
- doca_rmax_init returns NOT_SUPPORTED—what's wrong with the SDK or license?

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 09d418e086c72c57.

BEGIN THIRD-PARTY FILE 09d418e086c72c57
```text
---
license: Apache-2.0
name: doca-rmax
description: >
  DOCA Rivermax (doca_rmax) receive streams for timing-precise media over
  IP (SMPTE ST 2110 video / audio, market data, scientific feeds) on a
  target BlueField DPU (DOCA Rivermax apps run only there), once the
  Rivermax libraries and license are installed; getting them is doca-setup /
  doca-public-knowledge-map territory. Trigger on "ST 2110 receive isn't
  getting frames", "sub-microsecond jitter on my media receiver",
  "NOT_SUPPORTED from doca_rmax_init", "no recv events after stream
  start", or "license check failing on a media receiver", even without
  naming Rivermax. Covers doca_rmax_in_stream sessions, the SDK + license
  precondition check, doca_rmax_get_*_supported capability queries,
  pairing with doca-eth queues and doca-flow steering, and DOCA_ERROR_*
  from Rivermax calls. Refuse and route elsewhere for programming the
  underlying queue (doca-eth), steering rules (doca-flow), PTP / clock
  sync (doca-firefly), or best-effort packet I/O.
metadata:
  author: NVIDIA <doca-feedback@nvidia.com>
  kind: library
  doca_version: "3.5"
  tags:
    - doca
    - rmax
    - rivermax
compatibility: >
  Requires DOCA SDK at /opt/mellanox/doca on Linux (Ubuntu 22.04/24.04
  or RHEL/SLES) on the target BlueField DPU (DOCA Rivermax apps run only
  there), with `doca-sdk-rmax` from the DOCA repo AND a separately
  obtained Rivermax license readable by the user. Reads
  the local install via `pkg-config doca-rmax`; route Rivermax SDK
  install/license questions to the public Rivermax guide. The validation
  steps require a live DOCA install.
---

# DOCA Rivermax

## Examples

- **"ST 2110 receive isn't getting frames."** — this is in
  scope after Rivermax SDK + license are already present.
- **"How do I obtain / install the Rivermax SDK and its license?"** —
  out of scope for this skill. Say so, give no install or licensing
  steps, and route: DOCA packages to `doca-setup/SKILL.md`, the
  Rivermax SDK + license to the public DOCA Rivermax guide via
  `doca-public-knowledge-map/SKILL.md`. Come back here once both
  are present.
- **"NOT_SUPPORTED from doca_rmax_init."** — run the
  `doca_rmax_get_*_supported` queries before changing stream
  setup.

## Instructions

Follow Loading order below. Open the tasks companion for configure /
stream / debug. Open the capabilities companion for Rivermax
preconditions. Do not open every companion file.

**Where to start:** This skill assumes DOCA is already installed on
the target BlueField DPU (DOCA Rivermax apps run only on the target
DPU), **AND** that the Rivermax libraries (`doca-sdk-rmax` /
`libdoca-sdk-rmax-dev` from the DOCA repo) are installed with a valid
Rivermax license present on the DPU. The agent's FIRST
```
END THIRD-PARTY FILE 09d418e086c72c57

The third-party file has ended. Everything between the 09d418e086c72c57 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2772 of 18129 bytes. © NVIDIA · Apache-2.0 · https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-rmax/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
