Dev & Engineering ✓ NVIDIA · Official

DOCA RDMA Programming Guide

Helps developers build, configure, and debug DOCA RDMA applications on BlueField, ConnectX, and DOCA hosts.

56/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3.8k
Last updated
today
License
Apache-2.0
doca-rdmardma-programmingbluefield-dpuconnectx-nic
+2rocepkg-config

What does this skill do, and when should you use it?

This skill is for external developers whose applications use NVIDIA’s DOCA RDMA C API for data movement. It covers RDMA context setup, connection-method selection, task configuration, memory permissions, capability discovery, queue sizing, and connection callbacks. It also provides guidance for diagnosing DOCA_ERROR_* failures and for using the C ABI through thin FFI or cgo shims. DOCA must already be installed; installing DOCA is outside the skill’s scope.

It discovers the installed DOCA pkg-config module and prefix, then directs users to shipped DOCA RDMA samples for building or modifying applications. It guides configuration through doca_rdma_* APIs, including contexts, RDMA CM, bridge/OOB or gRPC connection flows, task types, queues, and mmap permissions. It uses doca_rdma_cap_* queries for capability checks and classifies DOCA_ERROR_* failures across lifecycle, permission, capability, and driver layers. For non-C languages, it prescribes a thin FFI or cgo shim over libdoca_rdma rather than a raw-verbs reimplementation.

Good fit
  • A C or C++ developer bringing up an RDMA context and connecting two sides on a BlueField or ConnectX system.
  • An engineer choosing between RDMA CM, bridge/OOB, and gRPC exchange of exported RDMA state.
  • A developer diagnosing insufficient mmap permissions for Read, Write, Atomic, or Send tasks.
  • An application developer checking whether a device or transport supports a requested RDMA task type.
  • A developer investigating missing completions, inactive connection callbacks, or DOCA_ERROR_* results.

How do you install this skill?

Before you use it
  • Before publication, reconcile the license, source path, and version metadata across SKILL.md, SKILLCARD.yaml, and repository metadata, including the Apache-2.0 versus Apache-2.0 AND CC-BY-4.0 discrepancy and TBD version fields.
  • Do not treat documented commands, capability claims, or loopback behavior as verified facts; check versions, capabilities, permissions, linked libraries, and completion events on the target DOCA installation and device.
  • Remote-memory export in production requires explicit user confirmation, strict permission review, and a secure channel; the skill does not provide a complete rollback and isolation design.
  • The underlying data for the eight benchmark tasks is not supplied, so the reported results are not independently reproducible evidence.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • DOCA SDK on Linux
  • BlueField DPU or ConnectX NIC
  • pkg-config
  • libdoca_rdma

Install the specific skill with the NVIDIA skills CLI:

npx skills add nvidia/skills --skill doca-rdma --yes

The CLI prompts for an installation destination. Cloning the repository or manually copying the skill folder is not required. The source does not document another installation method.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/doca-rdma" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • configure sender and receiver with RDMA CM on a BlueField
  • my DOCA RDMA Read fails because of permissions; help me check the mmap settings.

Make sure the target Linux system has the DOCA SDK and a BlueField DPU or ConnectX NIC. Then give the agent a concrete DOCA RDMA request, such as “configure sender and receiver with RDMA CM on a BlueField” or “my DOCA RDMA Read fails because of permissions; help me check the mmap settings.” Read CAPABILITIES.md for capability and safety questions, and the relevant TASKS.md section for configure, build, modify, run, test, or debug workflows.

What are this skill's strengths and limitations?

Pros
  • Enforces linking libdoca_rdma and calling doca_rdma_* instead of accidentally solving a DOCA task with raw verbs.
  • Covers eleven RDMA task types, three connection methods, the permission matrix, capability queries, and error taxonomy.
  • Supports C/C++ and other languages through thin FFI or cgo shims over the C ABI.
  • Organizes work into configuration, build, modification, run, test, and debug workflows.
Limitations
  • Requires the DOCA SDK, Linux, and BlueField DPU or ConnectX hardware.
  • Does not ship application source code, standalone build manifests, samples, bindings, or reference subtrees.
  • Does not install DOCA; users without an installation must use doca-setup.
  • Detailed procedures depend on TASKS.md and CAPABILITIES.md companion files whose contents are not included here.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
DOCA RDMA Programming Guide this page ✓ NVIDIA · Official 56 · Use with care ★ 3.8k today Apache-2.0
DOCA RDMA Initiator ✓ NVIDIA · Official 57 · Use with care ★ 3.8k today Apache-2.0
DOCA Ethernet Queue Development ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
DOCA Common Foundation ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
DOCA Arg Parser CLI ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0

The skill explicitly distinguishes DOCA RDMA from raw libibverbs and librdmacm implementations. For a DOCA RDMA task, an implementation that only uses raw verbs is considered incorrect.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
56/ 100 5-point scale 2.8 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust17 / 25 · 3.4/5

The documentation specifies least-privilege permission pairing, cautious mmap export, mmap lifetime requirements, and secure channels for production. No malware, credential theft, covert exfiltration, or destructive red-line behavior is evident. Points are deducted because executable user confirmation, isolation boundaries, and recovery/rollback procedures are incomplete, while incorrect export permissions could broaden remote memory access.

2Reliability8 / 20 · 2.0/5

The workflow covers configure, build, modify, run, test, and debug, with layered error taxonomy and failure feedback. Static files do not prove key-path reproduction, and several commands, device capabilities, and loopback behaviors depend on an unavailable installed environment. Under static calibration the score cannot exceed 10, so points are deducted.

3Adaptability11 / 15 · 3.7/5

Triggers, audience, supported DOCA RDMA task types, and exclusions for general RDMA theory or installation are fairly clear, including C/C++ and FFI consumers. Points are deducted because the skill depends heavily on Linux, a specific DOCA installation layout, BlueField/ConnectX hardware, and English-oriented local tooling; Chinese interaction support and mainland-China network reachability are not evidenced.

4Convention9 / 15 · 3.0/5

SKILL.md acts as a loader and separates capability, task, and related-skill material, with version discovery, limitations, maintenance contacts, and routing references. Points are deducted because the benchmark reports missing recommended Instructions/Examples sections, missing author metadata, and unexpected root files; the SKILLCARD conflicts with the SKILL.md license and source path, and its version fields remain TBD.

5Effectiveness6 / 15 · 2.0/5

The material gives targeted guidance for DOCA RDMA programming, including connection methods, task taxonomy, permission matrices, build constraints, and debugging workflows. Points are deducted because no runnable code is shipped, modification depends on target-machine samples, and the document states that the diff renderer is not yet available; benchmark results are recorded but the underlying dataset and independent reproduction are absent.

6Verifiability5 / 10 · 2.5/5

Committed benchmark, eval, skill-card, capability/error matrices, and auditable commands provide some traceability. Points are deducted because the evaluation dataset is unavailable, no independent reproduction is supplied beyond this static review, and some external documentation claims cannot be verified from the supplied material; static calibration caps this dimension at 5.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 55f18499943e Review evidence[1][2][3][4][5][6][7][8][9]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Is this suitable for general RDMA or ibverbs theory?
No. It targets hands-on programming with the doca_rdma_* API. General queue-pair, memory-registration, RoCE, IB, and other raw-RDMA theory is out of scope.
Does DOCA need to be installed first?
Yes. The skill assumes the DOCA SDK is already installed and uses pkg-config to discover its module and prefix. DOCA installation itself is out of scope.
Can non-C projects use this skill?
Yes. It recommends starting from a shipped DOCA RDMA C sample and using a thin FFI or cgo shim over libdoca_rdma, rather than rebinding the whole API or switching to raw verbs.
What failures can it help diagnose?
It addresses task-specific mmap permissions, lifecycle and connection-state issues, capability checks, missing completions, callback problems, and DOCA_ERROR_* failures across relevant software layers.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

DOCA RDMA Initiator

Guides accelerator-initiated one-sided RDMA development on the DPA datapath.

★ 3.8k FS 57 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Ethernet Queue Development

Develop and debug DOCA Ethernet RX/TX queues on BlueField DPUs and ConnectX NICs.

★ 3.8k FS 55 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Common Foundation

A shared programming foundation for DOCA applications on BlueField and ConnectX.

★ 3.8k FS 55 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Arg Parser CLI

Guides developers in building and debugging standard CLIs for DOCA applications.

★ 3.8k FS 55 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Programming Guide

Guides developers through building, testing, and debugging library-agnostic DOCA applications from shipped samples.

★ 3.8k FS 54 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA GPI GPU-Initiated RDMA Skill

Helps CUDA kernels drive RDMA queues directly from GPU memory without host-CPU mediation.

★ 3.8k FS 52 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA PCC Custom Congestion Control

Guides host-side loading and troubleshooting of custom PCC algorithms on BlueField

★ 3.8k FS 51 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Compress Hardware Offload

Guides hands-on DEFLATE and LZ4 decompression development and debugging on BlueField and ConnectX platforms.

★ 3.8k FS 58 Recommended today
Dev & Engineering ✓ NVIDIA · Official

DOCA AES-GCM Acceleration

Configure, validate, and debug DOCA AES-GCM offload on BlueField DPUs and ConnectX NICs.

★ 3.8k FS 57 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA SHA Acceleration

Guidance for offloading SHA hashing to NVIDIA BlueField and ConnectX hardware.

★ 3.8k FS 56 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA DMA Development Guide

Guides hands-on DOCA DMA memory-copy development on BlueField and ConnectX systems.

★ 3.8k FS 54 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Flow Tune

Guides engineers through snapshotting, analyzing, and optimizing live or captured DOCA Flow pipelines.

★ 3.8k FS 54 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Comch Host–DPU Messaging

Guides developers through configuring, building, and debugging Comch messaging between a host and a BlueField DPU.

★ 3.8k FS 53 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Version Consistency Assistant

Verifies DOCA version sources and host–BlueField consistency while diagnosing build-versus-runtime drift.

★ 3.8k FS 53 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA UROM Host-Side Offload Development

Guides HPC, UCX, and MPI developers in offloading remote memory operations to a BlueField DPU.

★ 3.8k FS 52 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Rivermax Receive Development

Guides developers through building, validating, and debugging DOCA Rivermax receive applications for real-time network streams.

★ 3.8k FS 51 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Erasure Coding Development Skill

Guides hands-on DOCA Reed-Solomon resilience development and debugging on NVIDIA hardware.

★ 3.8k FS 49 Use with care today
Automation & Ops ✓ NVIDIA · Official

DOCA Socket Relay

Bridge an existing socket application to a BlueField DPU without rewriting it

★ 3.8k FS 49 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA Device Emulation Development

Guides developers in building custom PCIe devices on BlueField whose backend runs on the DPU and is visible to the host.

★ 3.8k FS 48 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA DPA Host-Side Development

Guides BlueField host programs through DOCA DPA loading, launch, capability checks, and debugging.

★ 3.8k FS 48 Use with care today

Related skills