Dev & Engineering ✓ NVIDIA · Official

DOCA Arg Parser CLI

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

55/ 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
docaarg-parsercli-flagsbluefield-dpu
+3connectxc-cppjson-config

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

This Agent Skill is for developers performing hands-on DOCA Arg Parser work in shipped samples or new DOCA-using applications. It covers flag changes, lifecycle wiring, public parameter types, standard DOCA options, JSON configuration, version checks, and common `doca_argp_*` errors. It assumes the DOCA SDK is already installed, so it is not an installation guide or a general DOCA orientation resource.

It guides an agent to inspect the local DOCA installation through pkg-config doca-argp and /opt/mellanox/doca/{lib,include,samples,applications}. It prescribes the doca_argp_init → parameter registration → doca_argp_start → doca_argp_destroy order, helps select among six public parameter types, preserves --device, --representor, --rep-list, --json, and --sdk-log-level, and diagnoses BAD_STATE, INVALID_VALUE, NOT_SUPPORTED, and IO_FAILED results.

Good fit
  • A developer modifying a DOCA sample needs to add a custom flag without breaking the standard device and logging options.
  • A C or C++ developer is wiring Arg Parser initialization, registration, parsing, and cleanup into an application.
  • An application maintainer wants to use `--json <path>` for complex configuration instead of a long command line.
  • A DOCA debugger is investigating a parameter type mismatch, unknown JSON key, unreadable file, or lifecycle error.
  • A Rust, Go, or Python developer is wrapping the DOCA Arg Parser C ABI through FFI or bindings.

How do you install this skill?

Before you use it
  • No commands were executed; the DOCA API, error mappings, and workflows are not confirmed runnable for the target installation.
  • Parameter-type descriptions are inconsistent across the supplied documents; implementation should defer to the locally installed doca_argp.h and pkg-config results.
  • The skill concerns a DOCA device environment but does not sufficiently specify user confirmation, rollback, or hardware-impact boundaries.
  • Mainland-China network reachability is not established; core reference material may depend on overseas services.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • DOCA SDK installed at /opt/mellanox/doca
  • Linux with Ubuntu 22.04/24.04 or RHEL/SLES
  • BlueField DPU or ConnectX NIC
  • pkg-config

Install the specific skill with the supported skills CLI command: npx skills add nvidia/skills --skill doca-argp --yes. The CLI prompts for the installation destination; cloning the repository or manually copying the folder is not required. Before use, the target Linux host should have the DOCA SDK installed at /opt/mellanox/doca and have a BlueField DPU or ConnectX NIC attached.

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-argp" ~/.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?

After installation, trigger it with a relevant request such as: add a custom flag to a DOCA sample while preserving --device and --sdk-log-level. Other supported trigger patterns include BAD_STATE registering a new param, my JSON config key is rejected, and my sample's --json is ignored. The referenced TASKS.md contains configure, build, modify, run, test, and debug workflows; CAPABILITIES.md contains capability and error-taxonomy guidance.

What are this skill's strengths and limitations?

Pros
  • Covers parameter registration, lifecycle ordering, the standard DOCA CLI surface, JSON configuration, version detection, and error classification.
  • Explicitly distinguishes the six public parameter types and the requirement to register parameters before `doca_argp_start`.
  • Provides language-neutral rules for C/C++ and other languages that consume the same C ABI through FFI or bindings.
  • Defines clear routing boundaries for installation, DOCA Core, logging internals, variadic flags, subcommands, and shell completion.
Limitations
  • Requires the DOCA SDK at the standard path, supported Linux distributions, and NVIDIA networking hardware.
  • Does not ship pre-written usage code, standalone build manifests, samples, bindings, or reference artifacts.
  • The supplied material references `TASKS.md` and `CAPABILITIES.md` but does not include their full contents, so detailed procedures and test evidence cannot be assessed here.
  • Does not cover DOCA installation, subcommands, variadic flags, shell completion, DOCA Core contexts, or DOCA Log internals.

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 Arg Parser CLI this page ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
DOCA DMA Development Guide ✓ NVIDIA · Official 54 · Use with care ★ 3.8k today Apache-2.0
DOCA AES-GCM Acceleration ✓ NVIDIA · Official 57 · Use with care ★ 3.8k today Apache-2.0
DOCA Telemetry Exporter Development ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
DOCA Erasure Coding Development Skill ✓ NVIDIA · Official 49 · Use with care ★ 3.8k today Apache-2.0

The skill explicitly favors reusing DOCA Arg Parser over getopt, argparse, or custom parsing for DOCA-using applications that need the standard DOCA CLI surface. It does not provide a broader implementation or performance comparison of those alternatives.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
55/ 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.
1Trust16 / 25 · 3.2/5

The documentation scopes activity to a local DOCA installation, states that credentials are not required, and mostly recommends inspection and validation before changes. It lacks consistent user-confirmation, rollback, hardware-impact confirmation, and complete data-flow guidance, so points are deducted.

2Reliability8 / 20 · 2.0/5

Lifecycle rules, error taxonomy, troubleshooting, and test workflows are detailed. However, SKILL.md, CAPABILITIES.md, and TASKS.md are not fully consistent about the parameter-type set, and no execution was performed, so static evidence is insufficient for a higher score.

3Adaptability11 / 15 · 3.7/5

Audience, trigger phrases, use cases, and refusal boundaries are clearly defined. The skill nevertheless requires Linux, a local DOCA installation, and BlueField or ConnectX hardware, while reachability of referenced NVIDIA services from mainland China is not addressed.

4Convention10 / 15 · 3.3/5

The skill uses layered SKILL.md, CAPABILITIES.md, and TASKS.md documentation and provides related-skill routing, license information, and issue contacts. Versioning, changelog, author responsibility, and release metadata are incomplete; the SKILLCARD also contains TBD fields and conflicting license metadata.

5Effectiveness6 / 15 · 2.0/5

It provides directly usable workflows for flag changes, lifecycle ordering, JSON configuration, and error diagnosis. It ships no runnable code or templates, actual results depend on local hardware and installation, and BENCHMARK.md does not provide a reproducible evaluation dataset, so points are deducted.

6Verifiability4 / 10 · 2.0/5

Commands, error mappings, evaluation files, and a benchmark summary provide limited audit trails. There is no execution evidence, independent review, or committed CI test suite covering key paths, and the benchmark dataset is unavailable, so the score 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

Does installing this skill install the DOCA SDK?
No. It assumes DOCA is already installed at `/opt/mellanox/doca` and routes installation questions to `doca-setup`.
Which parameter types are supported?
The source lists six public types: string, int, boolean, device, device representor, and double. A JSON configuration file is an input surface, not a parameter type.
Why might parameter registration return `DOCA_ERROR_BAD_STATE`?
The source associates this error with lifecycle ordering: parameters must be registered before `doca_argp_start` parses argv.
Can I adopt it without a BlueField DPU or ConnectX NIC?
The stated compatibility requirements include an attached BlueField DPU or ConnectX NIC, so an environment without that hardware does not meet the documented prerequisites.

More skills from this repository

All from NVIDIA/skills

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 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 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 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
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 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 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 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 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 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 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
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 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 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 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 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 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 Device Management Development Skill

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

★ 3.8k FS 53 Use with care today

Related skills