Dev & Engineering ✓ NVIDIA · Official

DOCA Environment Setup

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

57/ 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
docabluefielddpuenvironment-setup
+3hugepagesdevlinkcontainer-deployment

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

This Agent Skill focuses on the environment surrounding NVIDIA DOCA workloads: installation health, build prerequisites, runtime prerequisites, and setup-class failures. It covers pkg-config, headers, library paths, hugepages, devlink visibility, representors, and kernel-module prerequisites, with an NGC DOCA container fallback for hosts without an install. Deployment-shaped requests are first classified by system shape and then routed toward container or bare-metal deployment guidance. It explicitly excludes DOCA library APIs, sample-derived application development, program build details, and DOCA_ERROR_* program debugging.

Reads SKILL.md and its TASKS.md and CAPABILITIES.md companion materials to classify requests and select workflows; guides target-host checks for DOCA installation, pkg-config, headers, library paths, hugepages, devlink, representors, and kernel prerequisites; detects deployment shape and routes to container, bare-metal, or no-install paths; applies verification and safety constraints before environment changes; and requires exact target-host command output when a command channel is unavailable.

Good fit
  • A BlueField developer who has a built workload but needs to choose between container and bare-metal deployment.
  • An engineer checking whether DOCA Flow and the surrounding build environment are healthy on a target system.
  • A developer troubleshooting missing doca-*.pc files, headers, library paths, hugepages, or representors.
  • A DPU operator preparing runtime prerequisites before launching a DOCA workload.
  • A macOS, Windows, or unconfigured Linux user who wants to learn or build with DOCA through the NGC container path.

How do you install this skill?

Before you use it
  • Unify the license and version metadata, and add authorship, changelog, maintenance ownership, and executable tests.
  • Require explicit confirmation, state capture, and a concrete rollback plan before changing hugepages, switchdev, mlxconfig, installation state, or reboot-sensitive configuration.
  • NGC/Docker paths depend on external services; validate reachability from mainland-China networks and document local or mirrored alternatives.
  • Do not treat the benchmark percentages as independently reproduced evidence in this static review.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Docker for the NGC container Stage-1 path
  • A live DOCA install at /opt/mellanox/doca for validation workflows

Install the individual skill from NVIDIA’s collection with: npx skills add nvidia/skills --skill doca-setup --yes. The supplied README says cloning the repository or manually copying skill folders is unnecessary; the CLI prompts for or applies the installation destination.

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-setup" ~/.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 just got a BlueField—what now?
  • Is DOCA Flow available on this box?
  • pkg-config cannot find doca-flow; what is missing?

After installation, invoke it with an environment- or deployment-shaped request such as “I just got a BlueField—what now?”, “Is DOCA Flow available on this box?”, or “pkg-config cannot find doca-flow; what is missing?” It classifies the request before selecting a workflow. Do not assume local shell access reaches the target host; provide a target-host command channel or have the user run the checks and return exact output.

What are this skill's strengths and limitations?

Pros
  • Covers the install, build, and runtime environment layers in one troubleshooting flow.
  • Separates container, bare-metal, and no-install paths instead of assuming a deployment shape.
  • Includes explicit safety constraints for hugepages, mlxconfig resets, and eswitch mode changes.
  • Provides an NGC DOCA container Stage-1 path for users without a DOCA installation.
Limitations
  • It is a thin loader whose substantive guidance depends on TASKS.md and CAPABILITIES.md companion files.
  • Hardware validation requires a target-host command channel or exact user-supplied output; local evidence is not assumed to represent the target.
  • It does not cover Flow or RDMA APIs, program construction, sample modification, program builds, or DOCA_ERROR_* debugging.
  • The supplied material does not show concrete validation commands, a test suite, or tested-platform evidence.

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 Environment Setup this page ✓ NVIDIA · Official 57 · 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
DOCA Telemetry Exporter Development ✓ NVIDIA · Official 55 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Programming Guide ✓ NVIDIA · Official 54 · 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

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
57/ 100 5-point scale 2.9 / 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 files explicitly require least privilege, user confirmation, disclosure of global hugepage/eswitch/install effects, no unattended reboot, and no privileged-container workarounds. However, they still prescribe sudo and global state changes, provide incomplete rollback guidance, and conflict on licensing between SKILL.md (Apache-2.0) and skill-card.md (Apache 2.0 AND CC-BY-4.0), so points are deducted.

2Reliability8 / 20 · 2.0/5

The recognize→configure→test→debug structure, stop conditions, and error taxonomy are comparatively detailed. However, this is a static review with no command execution, many key paths depend on unprovided companion skills, and the benchmark report lacks its source dataset, so the score is conservatively limited.

3Adaptability12 / 15 · 4.0/5

Triggers, covered scenarios, and explicit non-fit boundaries are clear across host, DPU, container, and bare-metal shapes. Chinese-language interaction is not addressed, and reachability of NGC/Docker-dependent paths from mainland-China networks is not assessed, so points are deducted.

4Convention9 / 15 · 3.0/5

The documentation has good layering, progressive loading, dependency notes, examples, limitations, and stated ownership. It lacks a clear changelog and maintenance/update procedure; the benchmark also records missing Instructions/Examples/Author metadata and unexpected companion files, while license metadata is inconsistent.

5Effectiveness6 / 15 · 2.0/5

The skill offers directly actionable checks, environment-preparation workflows, failure classification, and deployment routing, with clear core value. It is nevertheless a thin loader whose substantive outcomes depend on other skills and live environments; static review cannot establish successful completion, so the score remains below the execution-based ceiling.

6Verifiability4 / 10 · 2.0/5

Auditable commands, paths, cross-references, public documentation links, and a benchmark report are present. But the benchmark dataset is unavailable, no committed tests cover the key paths, and this review did not reproduce execution, warranting only limited credit.

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

Can I use it without DOCA installed?
Yes, for the no-install workflow, which points to the NGC DOCA container as Stage 1. That route requires an operating system capable of running Docker; installed-target validation requires a live DOCA installation at /opt/mellanox/doca.
Does it change hardware settings automatically?
The source describes guidance for safe environment changes, but requires the universal verification contract before recommending changes. Hugepages, mlxconfig resets, and eswitch mode changes are treated as safety-sensitive.
Does it answer DOCA Flow API questions?
No. Flow pipe construction, RDMA queues, sample-derived application work, program builds, and DOCA_ERROR_* debugging belong to other skills.

More skills from this repository

All from NVIDIA/skills

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
Automation & Ops ✓ NVIDIA · Official

DOCA Argus Runtime Security Operations

Deploy Argus on BlueField to detect runtime threats and forward findings to an existing SIEM.

★ 3.6k FS 50 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
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
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
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
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
Dev & Engineering ✓ NVIDIA · Official

DOCA Programming Guide

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

★ 3.6k FS 54 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 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
Automation & Ops ✓ NVIDIA · Official

DOCA Socket Relay

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

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

DOCA UROM Service Operations

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

★ 3.6k FS 45 Not recommended 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA AES-GCM Acceleration

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

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

DOCA BlueField-3 Bring-Up

Guides operators through BF3 day-one bring-up, recovery, RShim/BFB provisioning, and installation validation.

★ 3.6k FS 56 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
Automation & Ops ✓ NVIDIA · Official

DOCA Firefly Time-Synchronization Operations

Operate, configure, and troubleshoot DOCA Firefly PTP time synchronization on BlueField.

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

DOCA Erasure Coding Development Skill

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

★ 3.6k FS 49 Use with care 13d ago

Related skills