Dev & Engineering ✓ NVIDIA · Official

DOCA Verbs Raw RDMA Control

Guides DOCA developers who genuinely need low-level verbs control, porting, and diagnosis.

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-verbsrdmalibibverbsqp-management
+3completion-queuesbluefieldconnectx

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

This skill serves external developers using DOCA Verbs inside DOCA Core to control QPs, CQs, PDs, MRs, SRQs, address handles, and related Ethernet queue primitives. It first checks whether the higher-level DOCA RDMA, Eth, or Rivermax API already covers the request, preventing unnecessary descent into raw verbs. For cases requiring low-level attributes, capability queries, libibverbs porting, or error diagnosis, it routes users to capability guidance and configure, build, modify, run, test, and debug workflows. The skill is guidance only: it does not ship application source, build manifests, bindings, or migration scripts.

It reads the user's installed DOCA headers, libraries, samples, and applications, and checks the doca-verbs pkg-config module. It selects between higher-level DOCA libraries and doca_verbs_* based on the requested semantic, and guides capability checks using doca_verbs_query_device and the doca_verbs_device_attr_get_* family. It explains how to port libibverbs code into the DOCA Core lifecycle and progress engine while enforcing a no-mixing rule for the two handle models. For DOCA_ERROR_* results, especially DOCA_ERROR_IO_FAILED, it directs investigation toward the completion-queue entry and provides entry points for configure, build, modify, run, test, and debug workflows.

Good fit
  • An RDMA developer needs a specific work-request flag or QP attribute that doca_rdma_task_* does not expose.
  • A DOCA Core application requires explicit SRQ, completion-queue, or address-handle control.
  • A C or C++ developer is moving an existing libibverbs sender or receiver into the DOCA Core lifecycle and progress engine.
  • A developer needs to verify whether a device and DOCA version support a particular verb, opcode, WR flag, or QP feature.
  • A developer receives a DOCA_ERROR_* result from doca_verbs_*, especially IO_FAILED during work-request submission.
  • A developer is designing Rust, Go, Python, or another wrapper around the DOCA Verbs C ABI.

How do you install this skill?

Before you use it
  • Do not treat the workflows as a verified runnable implementation; confirm symbols, pkg-config versions, device capabilities, and samples on the target host.
  • Obtain explicit user authorization before device checks, sudo commands, or hardware-related configuration changes, and prepare a recoverable plan.
  • The SKILL.md, SKILLCARD.yaml, and supplied license/provenance metadata are inconsistent and should be reconciled before publication.
  • The benchmark report lacks its source dataset, so PASS and high percentages should not be treated as independently reproduced evidence.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • DOCA SDK installed at /opt/mellanox/doca
  • pkg-config
  • Linux with Ubuntu 22.04/24.04 or RHEL/SLES
  • BlueField DPU or ConnectX NIC

Install the specific skill with the repository's documented Skills CLI command: npx skills add nvidia/skills --skill doca-verbs --yes. You can also run npx skills add nvidia/skills --list to browse the catalog. Separately, the target Linux host or BlueField environment must already have the DOCA SDK installed at /opt/mellanox/doca; the supplied source does not document DOCA SDK installation.

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-verbs" ~/.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:

  • My doca_rdma_task_* abstraction does not expose the raw WR flag I need; should I use doca-verbs?
  • How do I port my libibverbs code into DOCA Core?

In an environment with DOCA installed, ask the agent about a confirmed raw-verbs requirement, for example: “My doca_rdma_task_* abstraction does not expose the raw WR flag I need; should I use doca-verbs?” or “How do I port my libibverbs code into DOCA Core?” The agent should first confirm that the higher-level library cannot express the semantic, then continue through CAPABILITIES.md and TASKS.md. General RDMA data movement, DOCA installation, and general libibverbs theory belong to other skills; the source provides no standalone doca-verbs application commands or code samples.

What are this skill's strengths and limitations?

Pros
  • Clearly limits raw verbs to cases where higher-level DOCA APIs are insufficient.
  • Covers low-level QP, CQ, PD, MR, SRQ, address-handle, Ethernet SQ/RQ, and congestion-control-group objects.
  • Provides focused routing for capability discovery, the libibverbs boundary, DOCA Core lifecycle, and error diagnosis.
  • Applies to C/C++ and to other languages using the same C ABI through FFI.
Limitations
  • Requires an installed DOCA SDK, a prepared Linux RDMA environment, and a BlueField DPU or ConnectX NIC.
  • Uses an experimental ABI tier whose symbols may change between DOCA releases; local headers are authoritative.
  • Ships no buildable source, build manifests, samples, bindings, reference subtree, or migration script.
  • The supplied material provides no independent test results or platform-coverage evidence for this individual skill.

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 Verbs Raw RDMA Control this page ✓ NVIDIA · Official 56 · Use with care ★ 3.8k today Apache-2.0
DOCA GPUNetIO Development Skill ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
DOCA Device Management Development Skill ✓ NVIDIA · Official 53 · Use with care ★ 3.8k today Apache-2.0
DOCA GPI GPU-Initiated RDMA Skill ✓ NVIDIA · Official 52 · Use with care ★ 3.8k today Apache-2.0
DOCA Hardware Telemetry Counter Reader ✓ NVIDIA · Official 60 · Recommended ★ 3.8k today Apache-2.0

Compared with higher-level DOCA libraries such as doca-rdma, doca-eth, and doca-rmax, doca-verbs is a targeted escape hatch for specific verbs, opcodes, work-request flags, queue attributes, or capability queries that those APIs do not expose; it is not the default data-movement interface. Compared with libibverbs, it integrates verbs objects and lifecycle into DOCA Core and uses the DOCA progress engine for completion handling; the source explicitly rejects mechanically mixing the two handle models.

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 requires confirming that a higher-level library is insufficient, forbids mixing ibv_* handles, mandates capability queries, and discloses the experimental ABI; it contains no credential harvesting or covert exfiltration guidance. However, it involves device access, RDMA configuration, and sudo-based checks without explicit user confirmation, rollback guidance, strong least-privilege boundaries, or complete data-flow disclosure, so points are deducted.

2Reliability8 / 20 · 2.0/5

The workflows, prerequisites, error taxonomy, completion inspection, and escalation paths are fairly detailed. Static review provides no executable reproduction, and several symbols must be confirmed from local headers, so key-path reliability cannot be established and the score remains conservatively below the static ceiling.

3Adaptability11 / 15 · 3.7/5

Triggers, non-fit cases, routing boundaries, and C/C++ plus FFI coverage are clearly described. The skill nevertheless depends heavily on Linux, an installed DOCA SDK, and BlueField or ConnectX hardware, with no explicit Chinese-language support or mainland-China reachability analysis, limiting environment-fit evidence.

4Convention10 / 15 · 3.3/5

The skill uses layered SKILL.md, CAPABILITIES.md, and TASKS.md documentation and includes installation, version, limitation, troubleshooting, maintenance, and evaluation material. However, the frontmatter lacks an author, the skill card has TBD version and signature fields, license metadata is inconsistent, and the static report notes missing recommended Instructions/Examples sections, so full marks are not justified.

5Effectiveness6 / 15 · 2.0/5

It can route users away from unnecessary raw verbs and provides configure, build, modify, run, test, and debug workflows. It ships no directly buildable code or samples, the unified-diff renderer is deferred, and representative outputs were not verified in this review, so effectiveness is limited to the static-review ceiling.

6Verifiability4 / 10 · 2.0/5

The skill directs users to installed headers and runtime capability queries as authorities and includes benchmark results and evaluation assertions. The evaluation dataset is unavailable, there is no independently reproducible evidence or committed test suite covering key paths, and the evidence is primarily maintainer-authored documentation, so verification remains limited.

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

Should I adopt this skill by default?
No. Adopt it only when the matching higher-level DOCA library genuinely cannot express the required semantic, or when porting libibverbs or diagnosing a doca_verbs_* error.
Does it include DOCA Verbs sample applications?
No. It directs developers to the C samples in their local DOCA installation and to build modifications in their own project directory.
Can I keep using ibv_* and doca_* on the same QP?
The source requires porting to doca_verbs_* handles and the DOCA Core lifecycle, and defines a no-mixing rule between the libibverbs and DOCA Verbs object models.
What hardware and software are required?
Linux, the DOCA SDK at /opt/mellanox/doca, pkg-config, and an attached BlueField DPU or ConnectX NIC are required.

More skills from this repository

All from NVIDIA/skills

Automation & Ops ✓ NVIDIA · Official

DOCA Bench Benchmarking Skill

Measure DOCA library throughput, latency, and bandwidth reproducibly on real NVIDIA networking hardware.

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

DOCA GPUNetIO Development Skill

Helps developers connect CUDA kernels on NVIDIA GPUs to DOCA network queues for GPU-side packet I/O and debugging.

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

DOCA Device Management Development Skill

Programmatically manage BlueField and ConnectX state through the DOCA C API.

★ 3.8k FS 53 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 Hardware Telemetry Counter Reader

Guides developers in reading per-domain hardware counters from BlueField and ConnectX devices.

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

DOCA Flow DPA Performance

Guides defensible measurement of DOCA Flow rule-update and disable rates on DPA-capable NVIDIA hardware.

★ 3.8k FS 58 Recommended today
Automation & Ops ✓ NVIDIA · Official

DOCA Capabilities Inspector

Inspect what DOCA can see on a host through a read-only device and capability CLI.

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

DOCA PCC Diagnostic Counters

Read fixed firmware and hardware PCC congestion diagnostics on ConnectX and BlueField devices.

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

DOCA Management Service Operations

Operate and troubleshoot NVIDIA DMS for centralized BlueField and ConnectX management.

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

DOCA STA Storage Target Acceleration

Build and debug RDMA NVMe-oF storage targets accelerated by DOCA STA on BlueField.

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

DOCA Telemetry Exporter Development

Guides DOCA applications in defining, emitting, and debugging structured telemetry for external consumers.

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

DOCA Flow Performance Measurement

Guides reproducible, defensible measurements of host-side and DPU-CPU DOCA Flow control-plane rule rates.

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

DOCA SHA OpenSSL Offload Engine

Adds DOCA SHA hardware acceleration to existing OpenSSL pipelines without rewriting the application around the doca-sha C API.

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

DOCA Flow gRPC Remote Control

Deploy, secure, smoke-test, and troubleshoot DOCA Flow’s gRPC control plane for non-C++ clients.

★ 3.8k FS 49 Use with care today
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 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 Arg Parser CLI

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

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

DOCA Upgrade Control

Safely gate DOCA upgrades and rollbacks with explicit confirmation.

★ 3.8k FS 55 Use with care today

Related skills