Agent skill · NVIDIA
doca-version
Use this skill when the user is doing DOCA version handling — detecting the installed release, validating the four-way match across pkg-config doca-common, applications/VERSION, doca_caps --version, and bfver/mlnx-release on BlueField, reasoning about NGC container tags, looking up whether a capability is on the installed release, or diagnosing build-vs-runtime drift. Trigger even when the user does not explicitly say "DOCA version" or "four-way match" — typical implicit phrasings include "program built but does nothing on the wire", "undefined reference to a symbol the docs claim exists", "DOCA_ERROR_NOT_SUPPORTED at runtime", "counter didn't increment", "what does `latest` mean for this tag", or "is my LTS still supported". Refuse and route elsewhere for installing or choosing DOCA packages (doca-setup), per-library API/capability questions (matching library skill), the cross-library DOCA_ERROR_* taxonomy (doca-programming-guide), or the general debug ladder (doca-debug) — those belong to other skills.
What it needs
About 6k tokens when loaded.
What this skill does
DOCA version Where to start: This skill is the bundle's single source of truth for DOCA version handling. Open TASKS.md if the user wants to do something with the version (detect / validate / diagnose mismatch); open CAPABILITIES.md when the question is what does version handling cover (the four-way match, the detection chain, NGC semantics, the per-library overlay pattern). Every other skill in the bundle that touches version routes here — they MUST NOT redefine the rules. Example questions this skill answers well The CLASSES of version-handling questions this skill is built to answer, each with one worked example. The agent should treat the class as the load-bearing piece — the worked example is a single instance. "What DOCA version do I actually have installed?" — worked example: "the docs say 3.3 but I'm not sure what's on this host". Answered by the canonical detection chain in TASKS.md ## configure + CAPABILITIES.md ## Capabilities and modes source-of-truth table. "My program built but does nothing on the wire — is my install consistent?" — worked example: "pkg-config --modversion says 3.3.0; docacaps --version says 3.2.0". Answered by the four-way match rule in CAPABILITIES.md ## Version compatibility the partial-install diagnosis in TASKS.md ## debug. "Is this DOCA capability / API / sample on the version I have?" — worked example: "is the symmetric-RSS hash mode in Flow 2.6.0". Answered by the version-matrix lookup procedure in TASKS.md ## test (which uses the version-matrix.json schema defined in doca-structured-tools-contract with fallback to per-library docs via doca-public-knowledge-map). "Can I run my host package version X against BFB version Y?" — worked example: "host is 3.3.0 LTS, BlueField BFB is 3.1.0". Answered by the routing to the DOCA Compatibility Policy documented in CAPABILITIES.md ## Version compatibility. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/doca-version