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.

52/ 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-urombluefield-dpuhpcucx
+3mpirdmaremote-memory-offload

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

This NVIDIA Agent Skill is for hands-on host-side development with the DOCA UROM library. It covers Service and Worker context lifecycles, remote-operation enqueueing, plugin capability discovery, completion progress, and DOCA_ERROR_* troubleshooting. It requires compatible DOCA installations on the host and BlueField, with the DPU-side UROM Service already running. It does not install DOCA, deploy the DPU service, bring up RDMA, or design MPI/UCX collective algorithms.

It directs the agent to inspect the local library with pkg-config doca-urom and examine libraries, headers, samples, and applications under /opt/mellanox/doca. It guides creation of doca_urom_service_* and doca_urom_worker_* contexts, enqueueing puts, gets, atomics, active messages, and collective primitives, progressing completion events, and calling doca_urom_service_get_plugins_list to discover available plugins. It also structures DOCA_ERROR_* diagnosis across installation, versioning, service reachability, RDMA transport, device capability, and application layers.

Good fit
  • An HPC developer wants to offload MPI or UCX remote-memory communication from host CPU cycles to a BlueField DPU.
  • A C or C++ application using doca_urom_* needs to create Service and Worker contexts and verify connectivity to the DPU service.
  • A developer needs to determine which UROM plugins, atomics, or collectives are supported by the current device, installation, and service version.
  • A UCX or MPI integration already wired to UROM returns DOCA_ERROR_NOT_PERMITTED on its first enqueue.
  • A Rust, Go, or Python wrapper around the UROM C ABI must preserve lifecycle, capability-discovery, and error-taxonomy rules.

How do you install this skill?

Before you use it
  • This is a low-confidence static review; no commands, tests, or UROM operations were executed.
  • Before use, reconcile the path, license, source, and version inconsistencies across SKILL.md, SKILLCARD.yaml, and BENCHMARK.md.
  • Do not apply the host-library guidance to DPU-side UROM Service deployment, and do not perform remote operations before confirming service health, version compatibility, plugin discovery, and RDMA health.
  • Core API and plugin capabilities depend on the local DOCA headers, samples, and actual service version; the document's summaries do not replace environment validation.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • DOCA SDK installed at /opt/mellanox/doca
  • Linux host running Ubuntu 22.04/24.04 or RHEL/SLES
  • BlueField DPU
  • DOCA UROM Service deployed and running on the DPU
  • Healthy RDMA fabric between host and BlueField

Install the skill from the NVIDIA/skills catalog with: npx skills add nvidia/skills --skill doca-urom --yes. The source does not document additional installation procedures; DOCA, the BlueField, the DPU-side UROM Service, and the RDMA environment must be prepared separately.

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

  • Help me offload MPI remote-memory operations to BlueField and debug DOCA_ERROR_NOT_PERMITTED from the first doca_urom_* call.

With the environment prerequisites satisfied, prompt the agent with a host-side task such as: “Help me offload MPI remote-memory operations to BlueField and debug DOCA_ERROR_NOT_PERMITTED from the first doca_urom_* call.” Read SKILL.md first; read CAPABILITIES.md for the capability matrix and TASKS.md for configure, build, modify, run, test, or debug workflows. Do not use this skill for DPU-side UROM Service deployment or MPI/UCX algorithm design.

What are this skill's strengths and limitations?

Pros
  • Clearly separates the host library from the DPU-side UROM Service, addressing common pairing and version problems.
  • Covers a host-side workflow from configuration and build through run, test, and debug.
  • Uses plugin discovery as the capability surface for the current device, installation, and service version.
  • Applies to C/C++, UCX/MPI integrations, and other languages using the C ABI through FFI.
Limitations
  • Provides no ready-to-compile application source, bindings, build manifests, or samples subtree.
  • Depends on an installed and compatible DOCA SDK, BlueField DPU, DPU service, and healthy RDMA transport.
  • Excludes DPU-side service operations, DOCA installation, RDMA bring-up, and MPI/UCX collective algorithm design.
  • The source provides no independent test results or platform-coverage data for this 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 UROM Host-Side Offload Development this page ✓ NVIDIA · Official 52 · 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 GPI GPU-Initiated RDMA Skill ✓ NVIDIA · Official 52 · Use with care ★ 3.8k today Apache-2.0
DOCA Compress Hardware Offload ✓ NVIDIA · Official 58 · Recommended ★ 3.8k today Apache-2.0
DOCA RDMA Programming Guide ✓ NVIDIA · Official 56 · Use with care ★ 3.8k today Apache-2.0

For simple point-to-point RDMA where host CPU usage is not the bottleneck, the source recommends using doca-rdma directly. UROM builds a DPU-offload and service-pairing contract on top of the RDMA transport substrate.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 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 clearly separates the host library from the DPU service and requires checking service state, device, versions, plugins, and memory objects. No credential theft, covert exfiltration, or destructive default was found. Points are deducted because it guides hardware, network, and remote-service actions without explicit rollback, least-privilege controls, or external-effect safeguards; license metadata is also inconsistent across the supplied files.

2Reliability8 / 20 · 2.0/5

Loading order, prerequisites, lifecycle, error taxonomy, and layered debugging are reasonably consistent, and abnormal cases generally require investigation rather than blind retries. Points are deducted because key paths were not executed in this static review and no committed comprehensive test suite is supplied; several API, plugin, and service behaviors depend on the local installation.

3Adaptability10 / 15 · 3.3/5

The audience, host-side scope, trigger phrases, non-fit cases, and routing boundaries are unusually explicit, including C/C++ and FFI users. Points are deducted because the skill strictly depends on Linux, an installed DOCA SDK, BlueField hardware, a running DPU service, and a healthy RDMA fabric; Chinese-language interaction and mainland-China reachability are not addressed, and the skill is unusable without the required environment.

4Convention7 / 15 · 2.3/5

The package uses progressive disclosure through SKILL.md, CAPABILITIES.md, and TASKS.md, with workflows, example questions, error tables, and related-skill routing. Points are deducted for incomplete versioning, changelog, authorship, and maintenance details; the benchmark reports missing recommended sections and unavailable evaluation data, while SKILLCARD metadata conflicts with the supplied path, license, and provenance.

5Effectiveness6 / 15 · 2.0/5

The material can help an agent decide when to load the skill and guide host-side UROM configuration, plugin discovery, build, run, test, and debugging. Points are deducted because it intentionally ships no runnable code or templates, depends on local samples, headers, the DPU service, and RDMA infrastructure, and contains no independently confirmable representative output in the static evidence.

6Verifiability4 / 10 · 2.0/5

The files contain many auditable cross-references, command and API names, error mappings, and an evaluation summary. Points are deducted because the evaluation dataset is unavailable, no independently reproducible test suite or third-party execution evidence is supplied, and important claims depend on external documentation and the user's local DOCA installation.

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

Does this skill deploy the UROM Service on the BlueField?
No. It covers the host-side UROM library; DPU-side service deployment and operation are explicitly outside its scope.
What must be available before adoption?
The source requires an accessible DOCA installation on the host, a compatible BlueField, a running compatible DPU-side UROM Service, and healthy RDMA connectivity. Specific permission details are not documented.
What can cause DOCA_ERROR_NOT_PERMITTED on the first UROM call?
The skill identifies service deployment or reachability, version skew, device access restrictions, and underlying RDMA failures as layers to investigate.
Does the skill include runnable examples?
No. It directs users to the installed DOCA C samples under /opt/mellanox/doca/samples/doca_urom/.

More skills from this repository

All from NVIDIA/skills

Automation & Ops ✓ NVIDIA · Official

DOCA UROM Service Operations

Deploy and troubleshoot the DOCA UROM service container on BlueField Arm.

★ 3.8k FS 45 Not recommended 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 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
Automation & Ops ✓ NVIDIA · Official

Dynamo Interconnect Readiness Check

Verify RDMA, NVLink, and NIXL transport readiness before trusting performance results from disaggregated Dynamo serving.

★ 3.8k FS 52 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 RDMA Programming Guide

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

★ 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 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 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 Verbs Raw RDMA Control

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

★ 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
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 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 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
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 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

Related skills