Dev & Engineering ✓ NVIDIA · Official

DOCA PCC Custom Congestion Control

Guides host-side loading and troubleshooting of custom PCC algorithms on BlueField

51/ 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
nvidia-docabluefield-dpuprogrammable-congestion-controlrdma-roce
+2dpacchost-side-c-api

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

This skill is for developers using the DOCA PCC library from the host side to load a custom congestion-control algorithm onto a BlueField DPU. It covers per-port doca_pcc contexts, loading a DPACC-produced algorithm image, port attachment, parameterization, capability discovery, and DOCA_ERROR_* troubleshooting. It assumes an installed DOCA SDK, a host-visible DPA processor, firmware with the custom-PCC slot enabled, and a DPACC version matched to DOCA. It does not cover DPA-side algorithm authoring, environment installation, factory firmware PCC, or the pcc_counters tool.

Reads the local DOCA installation and pkg-config doca-pcc data, and inspects libraries, headers, samples, and applications under /opt/mellanox/doca; guides creation of per-port doca_pcc contexts, loading of a dpacc-produced doca_pcc_app, attachment to the BlueField port carrying RDMA/RoCE traffic, parameterization, and context startup; uses doca_pcc_cap_* for capability checks and classifies DOCA_ERROR_* across device, firmware, image, and driver layers.

Good fit
  • A BlueField host-side developer needs to load a custom congestion-control algorithm onto a port carrying RoCE traffic.
  • A developer needs to verify whether the current BlueField, DOCA installation, and firmware support custom PCC.
  • An algorithm load returns DOCA_ERROR_NOT_PERMITTED and the developer needs to distinguish firmware-slot configuration from access permissions.
  • A doca_pcc_* call returns DOCA_ERROR_DRIVER and the developer needs to isolate the failing layer.
  • A developer is designing a Rust, Go, or Python host wrapper that drives an algorithm image built separately with DPACC.

How do you install this skill?

Before you use it
  • Do not treat the documented workflow as an independently verified executable recipe; before operating on a real BlueField, firmware slot, or RoCE traffic, obtain confirmation of the port, versions, parameters, impact, and recovery steps.
  • License and provenance metadata are inconsistent; verify the actual license, authorship, version, and signature state before publication.
  • Core references depend on external NVIDIA documentation; provide local or reachable alternatives, especially for mainland-China users.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • DOCA SDK installed at /opt/mellanox/doca
  • Linux on Ubuntu 22.04/24.04 or RHEL/SLES
  • BlueField DPU with host-visible DPA processor
  • Firmware with custom-PCC slot enabled
  • DPACC compiler version matched to DOCA

Install the individual skill with the repository's skills CLI: npx skills add nvidia/skills --skill doca-pcc --yes. You may omit --yes to let the CLI prompt for the skill and installation destination. After installation, the Agent loads it when it encounters a relevant task.

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

  • Load my custom congestion-control algorithm onto the BlueField port carrying RoCE traffic
  • Investigate DOCA_ERROR_NOT_PERMITTED from my doca_pcc algorithm load.

After installation, give the Agent a host-side custom-PCC request such as: "Load my custom congestion-control algorithm onto the BlueField port carrying RoCE traffic" or "Investigate DOCA_ERROR_NOT_PERMITTED from my doca_pcc algorithm load." For configure, build, modify, run, test, or debug tasks, the skill directs the Agent to TASKS.md; for API capability questions, it directs the Agent to CAPABILITIES.md. The supplied SKILL.md does not include the complete command sequence or API signatures.

What are this skill's strengths and limitations?

Pros
  • Covers the host-side PCC lifecycle from prerequisite discovery through loading, attachment, parameterization, and debugging.
  • Separates the three major precondition axes: BlueField DPA capability, firmware custom-PCC enablement, and DOCA capability queries.
  • Clearly distinguishes custom PCC from DPA algorithm authoring, factory firmware PCC, and pcc_counters.
  • Supports language-neutral host-side wrappers while preserving the DOCA/DPACC version-match requirement.
Limitations
  • Requires a preinstalled DOCA SDK, DPACC, and BlueField hardware meeting the firmware prerequisites.
  • Provides no prewritten PCC application, DPA algorithm, build manifest, or bindings.
  • Does not cover DPA-side congestion-control design or RDMA/RoCE traffic setup.
  • The supplied SKILL.md is primarily orientation and routing; detailed workflows are in companion files not included in the prompt.

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 PCC Custom Congestion Control this page ✓ NVIDIA · Official 51 · Use with care ★ 3.8k today Apache-2.0
DOCA SPCX Programmable Congestion Control ✓ NVIDIA · Official 54 · Use with care ★ 3.8k today Apache-2.0
DOCA DPA Host-Side Development ✓ NVIDIA · Official 48 · Use with care ★ 3.8k today Apache-2.0
DOCA SHA Acceleration ✓ NVIDIA · Official 56 · Use with care ★ 3.8k today Apache-2.0
DOCA PCC ZTR RTTCC Congestion Control ✓ NVIDIA · Official 48 · Use with care ★ 3.8k today Apache-2.0

Compared with factory firmware PCC, this skill targets custom algorithms loaded through the host-side doca-pcc library; factory PCC does not require that host-side API. Compared with pcc_counters, this skill loads, attaches, and parameterizes a custom algorithm, while pcc_counters is a separate runtime counter-inspection tool.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
51/ 100 5-point scale 2.6 / 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.
1Trust17 / 25 · 3.4/5

The documentation clearly limits scope to host-side custom PCC, requires checking the three capability axes, firmware slot, target port, parameter ranges, and reverse-order cleanup after stop. No credential theft, covert exfiltration, or destructive default behavior is evident. Points are deducted because the workflow touches real DPU, firmware, and RoCE traffic; user confirmation, rollback, and data-flow disclosure remain incomplete, and license metadata conflicts across Apache-2.0, Apache-2.0 AND CC-BY-4.0, and repository NOASSERTION.

2Reliability8 / 20 · 2.0/5

SKILL.md, CAPABILITIES.md, and TASKS.md provide a fairly complete configure/build/run/test/debug structure with error taxonomy and layered failure handling. Static files contain no executable reproduction, complete API recipes, or committed test suite; key steps depend on other skills or external documentation. Under the static ceiling, runtime reliability cannot be established beyond a moderate score.

3Adaptability10 / 15 · 3.3/5

Trigger conditions, audience, exclusions, and routing between custom PCC, default PCC, and pcc_counters are clearly stated, including C/FFI and DPA compiler constraints. Points are deducted because the target environment is highly specialized, Chinese-language support is only indirect, and some core guidance depends on NVIDIA-hosted documentation or a local DOCA installation, with no evidence of mainland-China network reachability.

4Convention8 / 15 · 2.7/5

The skill uses layered SKILL.md, CAPABILITIES.md, and TASKS.md documentation and includes dependencies, version checks, limitations, related skills, maintenance intake, and a benchmark report. Points are deducted for no explicit author, changelog, or stable version policy; the skill card retains TBD version/signature fields, and path and license metadata are inconsistent.

5Effectiveness5 / 15 · 1.7/5

The skill directly supports scope selection, three-axis preflight checks, port attachment, lifecycle ordering, and error diagnosis for custom PCC. Points are deducted because it is primarily routing and workflow guidance, not a directly buildable sample or complete command/code package; static review cannot verify usable final outputs, and the benchmark report says the source evaluation dataset was unavailable.

6Verifiability3 / 10 · 1.5/5

The materials provide a pinned revision, error mappings, version checkpoints, evaluation summary, and official reference links, giving limited auditability. Points are deducted because there is no committed test suite or real CI coverage of key paths, the benchmark dataset is unavailable, and many technical claims remain author-provided and cannot be independently reproduced from a static read.

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

Can this skill write the DPA-side congestion-control algorithm for me?
No. The user must provide source accepted by DPACC and compile it separately; algorithm design belongs with the public DOCA PCC and DPA/DPACC programming guides.
Why can loading fail even when doca_dev is accessible?
Custom PCC additionally requires a host-visible DPA on the BlueField and firmware with the custom-PCC slot enabled; ordinary doca_dev access alone is insufficient.
Should I use this skill only to inspect PCC counters?
No. pcc_counters is a separate diagnostic artifact and should be handled through the DOCA Tools documentation path.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

DOCA SPCX Programmable Congestion Control

Operate and evaluate SPCX congestion-control algorithms on BlueField DPA before production rollout.

★ 3.8k FS 54 Use with care today
Dev & Engineering ✓ NVIDIA · Official

DOCA DPA Host-Side Development

Guides BlueField host programs through DOCA DPA loading, launch, capability checks, and debugging.

★ 3.8k FS 48 Use with care 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 PCC ZTR RTTCC Congestion Control

Deploy, tune, and validate NVIDIA’s RoCE RTT congestion-control reference algorithm on BlueField-3.

★ 3.8k FS 48 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
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 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 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 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 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 Arg Parser CLI

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

★ 3.8k FS 55 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 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 STA Storage Target Acceleration

Build and debug RDMA NVMe-oF storage targets accelerated by DOCA STA on BlueField.

★ 3.8k FS 55 Use with care today
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 Flow DPA Provider

Guides developers in exporting DOCA Flow pipes and resources into BlueField DPA for direct kernel-side access and mutation.

★ 3.8k FS 53 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 UROM Host-Side Offload Development

Guides HPC, UCX, and MPI developers in offloading remote memory operations to a BlueField DPU.

★ 3.8k FS 52 Use with care today
Automation & Ops ✓ NVIDIA · Official

DOCA Management Service Operations

Operate and troubleshoot NVIDIA DMS for centralized BlueField and ConnectX management.

★ 3.8k FS 55 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

Related skills