doca-verbs

What it does

This skill acts as a gatekeeper for raw-verbs tasks under DOCA Core, instructing the agent to route users back to the appropriate higher-level library when their needs are already covered, and only engage raw-verbs handling when a specific verb, opcode, WR flag, QP attribute, SRQ option, or error diagnosis is truly not exposed by the higher-level APIs. It frames when to load, what surface areas are within scope, and how to determine whether raw verbs are necessary.

How it works

The skill outlines a decision flow:

• Confirm whether the user’s task requires raw-verbs versus higher-level libraries (doca-rdma, doca-eth, doca-rmax). If not, route to the appropriate library.
• If the user needs a specific verb/option not exposed by the higher-level surface, determine that the task is in scope for doca-verbs and proceed to provide guidance on integration using DOCA Core constructs (doca_verbs_context, doca_verbs_query_device, etc.).
• Emphasize porting libibverbs code only when necessary and outline the integration path (lifecycle, progress engine, no-mixing rule).
• Use companion CAPABILITIES.md and TASKS.md as references for capabilities, safety, and workflows; steer to doca-setup for installation if needed.
• Provide guidance on when to climb back up to a higher-level library and when to extend non-C bindings.

When to use it

Load this skill when the user explicitly or implicitly questions raw-verbs usage because the higher-level DOCA libraries do not expose the required semantics. Triggered in scenarios like needing a specific raw WR flag, a unique QP attribute, custom CQ handling, or porting libibverbs code into the DOCA Core model.

What it can touch

The skill references the DOCA Verbs surface and the related files for deeper guidance, including CAPABILITIES.md and TASKS.md for workflows, and relies on the DOCA SDK being installed at the standard path. It indicates that the substantive material lives in companion files and does not itself ship sample code or standalone manifests. It also implies interaction with the DOCA environment (pkg-config doca-verbs, /opt/mellanox/doca paths).

Caveats

The skill explicitly refuses loading for general DOCA RDMA/Eth/RMAX tasks, DOCA install, Core internals, or libibverbs theory unless the user needs raw-verbs attributes. It promotes routing back to higher-level libraries for most workloads and requires confirmation that the specific needs are not exposed by those libraries before engaging raw-verbs guidance.