Dev & Engineering ✓ NVIDIA · Official

DOCA Programming Guide

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

54/ 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.6k
Last updated
13d ago
License
Apache-2.0
docac-cppmesonpkg-config
+3ffibluefieldgpu-programming

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

This skill is for external developers who consume DOCA libraries in applications. It covers first-application derivation, the canonical pkg-config and Meson build pattern, the common DOCA object lifecycle, cross-library error handling, observability, validation, and debugging. C and C++ are the canonical paths, while Rust, Go, and Python are addressed through FFI or bindings against the public C ABI. It assumes the DOCA environment is already prepared and routes installation, version lookup, and library-internal API questions elsewhere.

Reads the skill guidance and its CAPABILITIES.md and TASKS.md companion materials; directs users to C samples installed under /opt/mellanox/doca for minimal-diff customization; describes the pkg-config doca-{library} plus Meson build pattern and non-C FFI against the public C ABI; explains the cfg-create→init→start→use→stop→destroy lifecycle; and guides users through doca_error_get_descr() for DOCA_ERROR_* values, validation, testing, and the program-class debugging ladder.

Good fit
  • A developer writing a first application against any DOCA library and looking for a shipped sample to modify.
  • A C or C++ developer choosing the standard pkg-config and Meson build line for APIs such as doca_rdma_*.
  • A Rust, Go, or Python developer calling DOCA through the public C ABI without authoring a C wrapper.
  • A developer diagnosing DOCA_ERROR_BAD_STATE or an application that starts successfully but produces no traffic.
  • A developer classifying sample and application build failures, including missing optional GPU, RMAX, or MPI stacks.

How do you install this skill?

Before you use it
  • Running or modifying DOCA programs may affect real NICs, DPUs, representors, queues, or network traffic; obtain explicit user confirmation and define a recoverable rollback before execution.
  • The skill depends on a version-compatible DOCA installation, Linux or container access, and sometimes real hardware; it provides no Chinese-language or mainland-China network reachability guarantee.
  • Do not treat the BENCHMARK.md summary as independent test proof; the raw dataset is unavailable and this review executed nothing.
  • Before publication, reconcile the license, author, and maintenance metadata between SKILL.md and skill-card.md.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Node.js
  • Meson
  • pkg-config
  • DOCA installation at /opt/mellanox/doca for validation steps

Use the installation flow documented in the repository README: npx skills add nvidia/skills --skill doca-programming-guide --yes. The CLI prompts for the installation destination; cloning the repository or manually copying the folder is not required. The source does not specify a fixed local installation path.

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

  • I want to write my first DOCA Flow application
  • How do I call DOCA Comch from Rust without writing C?

After installation, prompt the agent with a programming request such as “I want to write my first DOCA Flow application” or “How do I call DOCA Comch from Rust without writing C?”. The DOCA environment should already be ready and pkg-config doca-{library} should resolve. Route installation, hugepages, device visibility, version lookup, and library-specific API construction to the related skills.

What are this skill's strengths and limitations?

Pros
  • Covers the library-agnostic DOCA workflow from first sample through build, lifecycle, errors, observability, testing, and debugging.
  • Provides both direct C/C++ guidance and language-neutral FFI guidance for Rust, Go, Python, and similar consumers.
  • Clearly separates programming questions from setup, public-knowledge routing, and library-internal API questions.
  • Uses shipped, installed samples as the source for verified application code instead of supplying unverified implementations.
Limitations
  • The SKILL.md is a thin loader; substantive workflows are delegated to CAPABILITIES.md and TASKS.md.
  • It does not include application source, bindings, standalone build manifests, or samples/reference subtrees.
  • It does not handle DOCA installation, hugepages, device preparation, version lookup, or library-specific API construction.
  • Validation steps require a live DOCA installation at /opt/mellanox/doca.

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 Programming Guide this page ✓ NVIDIA · Official 54 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Telemetry Exporter Development ✓ NVIDIA · Official 55 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Version Consistency Assistant ✓ NVIDIA · Official 53 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Arg Parser CLI ✓ NVIDIA · Official 55 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Comch Host–DPU Messaging ✓ NVIDIA · Official 53 · Use with care ★ 3.6k 13d ago Apache-2.0

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
54/ 100 5-point scale 2.7 / 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.
1Trust18 / 25 · 3.6/5

The skill defines scope boundaries, validation-before-commit, staged execution, smallest-scope operation, install-tree protection, and routing between environment and program failures. This supports a strong but incomplete trust score. Points were deducted because hardware-affecting commands, containers, file copying, and runtime actions lack a consistent user-confirmation gate, rollback procedure, and explicit external-effect confirmation; license metadata is also inconsistent across files.

2Reliability8 / 20 · 2.0/5

SKILL.md, CAPABILITIES.md, and TASKS.md provide structured loading order, prerequisites, lifecycle guidance, error taxonomy, and diagnostic routing, with frequent stop-and-route behavior on failure. Points were deducted because key paths were not executed during this static review, many API and cross-library claims lack committed tests, and the benchmark dataset is unavailable, so the reported benchmark cannot establish full reproduction.

3Adaptability10 / 15 · 3.3/5

The audience, trigger phrases, use cases, and non-fit boundaries are unusually explicit, and the skill addresses both C/C++ and FFI consumers. Points were deducted because it depends on an installed DOCA environment, Linux or a container, and often real hardware; Chinese-language interaction is not addressed, nor is reachability of public documentation, forums, or NGC from mainland-China networks.

4Convention8 / 15 · 2.7/5

The documentation is layered into a loader, capability reference, and task workflows, with dependency notes, related-skill routing, examples, version rules, and stated limitations. Points were deducted for the missing author field, missing recommended Instructions/Examples sections, lack of a clear maintenance owner and update path, no formal changelog, and inconsistent licensing: Apache-2.0 in SKILL.md versus Apache 2.0 AND CC-BY-4.0 in skill-card.md.

5Effectiveness6 / 15 · 2.0/5

The skill covers first-app derivation, pkg-config/Meson builds, lifecycle management, error interpretation, testing, and debugging with concrete workflows; BENCHMARK.md reports a pass and strong assisted metrics. Points were deducted because it ships no directly buildable sample or template, depends on the user's installation, version, hardware, and library-specific overlays, and the unavailable evaluation dataset plus lack of execution prevents confirming directly usable results.

6Verifiability4 / 10 · 2.0/5

Most documented workflows, commands, paths, and symbols are auditable from the supplied files, with references to public documentation, samples, and repositories; BENCHMARK.md adds limited evaluation-summary evidence. Points were deducted because this review performed no execution, the benchmark dataset and raw trial records are missing, and independent corroboration is thin.

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]

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 include a buildable DOCA sample?
No. It directs users to the official C samples installed under /opt/mellanox/doca and prescribes minimal modifications.
Can it be used without a DOCA installation?
The guidance can be read without an installation, but its validation steps require one. Installation and the no-install NGC container path belong to doca-setup.
Does it explain Flow pipe topology or RDMA queue construction?
Not as its primary scope. Those library-internal API questions should use the matching library skill layered on top of this guide.
Do I need to clone NVIDIA/skills to install it?
No. The README documents npx skills add nvidia/skills --skill doca-programming-guide --yes.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

DOCA Telemetry Exporter Development

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

★ 3.6k FS 55 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Version Consistency Assistant

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

★ 3.6k FS 53 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Arg Parser CLI

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

★ 3.6k FS 55 Use with care 13d ago
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.6k FS 53 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Environment Setup

Verify, prepare, and troubleshoot the DOCA environment while routing workloads to the right deployment path.

★ 3.6k FS 57 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Capabilities Inspector

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

★ 3.6k FS 56 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA PCC Diagnostic Counters

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

★ 3.6k FS 56 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Structured Tools Contract

A governed fallback contract for consolidating DOCA environment, device, capability, validation, and host-DPU state data.

★ 3.6k FS 55 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Upgrade Control

Safely gate DOCA upgrades and rollbacks with explicit confirmation.

★ 3.6k FS 55 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA CollectX Telemetry Deployment

Deploy, operate, and debug CollectX telemetry collectors so counters reach downstream exporters.

★ 3.6k FS 54 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA BlueField Bare-Metal Deployment

Run, supervise, and troubleshoot DOCA binaries directly on BlueField hardware.

★ 3.6k FS 53 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Container Deployment

Deploy, validate, and troubleshoot DOCA service containers on NVIDIA BlueField.

★ 3.6k FS 52 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA DPA High-Level Tracer

Capture and decode BlueField DPA programming events to diagnose kernel behavior, communication latency, and trace failures.

★ 3.6k FS 50 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA GPUNetIO WRITE Bandwidth Benchmark

Build, run, and interpret sustained RDMA WRITE bandwidth measurements driven by CUDA kernels through the DOCA GPUNetIO surface.

★ 3.6k FS 50 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA RDMA Programming Guide

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

★ 3.6k FS 56 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Hardware Telemetry Counter Reader

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

★ 3.6k FS 60 Recommended 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA RDMA Initiator

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

★ 3.6k FS 57 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA SHA Acceleration

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

★ 3.6k FS 56 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Common Foundation

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

★ 3.6k FS 55 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA DMA Development Guide

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

★ 3.6k FS 54 Use with care 13d ago

Related skills