Dev & Engineering ✓ NVIDIA · Official

DOCA Compress Hardware Offload

Guides hands-on DEFLATE and LZ4 decompression development and debugging on BlueField and ConnectX platforms.

58/ 100
Recommended

Generally reliable with disclosed limitations; trial as directed and keep a rollback path.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3.8k
Last updated
today
License
Apache-2.0
doca-compressdeflatelz4-decompressionbluefield-dpu
+3connectxhardware-offloadc-api

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

This skill serves external developers using the DOCA Compress C library. It covers DEFLATE compression, DEFLATE decompression, and LZ4 stream or block decompression on a BlueField DPU, ConnectX NIC, or DOCA-enabled host. It explains context setup, device capability and per-task buffer-limit queries, mmap permissions, completion events, and DOCA_ERROR_* diagnosis. It also helps decide whether bulk data should be offloaded or handled by CPU zlib/zstd. It does not install DOCA or ship buildable application source, bindings, fixtures, or standalone build manifests.

Guides users to inspect the local DOCA installation with pkg-config --modversion doca-compress and examine libraries, headers, samples, and applications under /opt/mellanox/doca. It covers doca_compress context setup, the compress-deflate and decompress-deflate task APIs, capability checks, source and destination sizing, mmap permissions, lifecycle, progress-engine completion events, and layered error diagnosis. It prescribes round-trip validation or decompression of a known DEFLATE fixture before bulk accelerator use.

Good fit
  • A developer compressing a multi-megabyte log buffer on BlueField who needs to compare DOCA offload with CPU zlib.
  • A network service on ConnectX that only receives DEFLATE payloads and needs decompression without enabling compression.
  • An application returning DOCA_ERROR_INVALID_VALUE from doca_compress_task_compress_deflate_alloc_init.
  • A developer receiving DOCA_ERROR_NOT_PERMITTED and checking source and destination mmap access flags.
  • A submitted task that produces no completion event and requires lifecycle, sizing, permission, and support checks.
  • A Rust, Go, or Python wrapper that must preserve the Compress C ABI's capability, permission, and lifecycle rules.

How do you install this skill?

Before you use it
  • Do not treat the PASS verdict or high benchmark scores as independently executed, reproducible evidence; the evaluation dataset is not supplied.
  • Before real-device use, defer to local headers, pkg-config, doca_caps, and actual doca_devinfo capability queries, especially for LZ4 task APIs and version compatibility.
  • The skill guides hardware accelerator, mmap, and task-queue operations; perform the minimal round-trip smoke only after confirming rollback, task draining, and mmap lifetime handling.
  • Chinese users may need additional translation and terminology checking; core use depends on a local DOCA installation and the NVIDIA ecosystem.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • DOCA SDK installed at /opt/mellanox/doca
  • Linux
  • BlueField DPU or ConnectX NIC
  • C library with pkg-config module doca-compress

Install the specific skill with the default skills CLI: npx skills add nvidia/skills --skill doca-compress --yes. The CLI installs it to a selected agent destination; the README does not document a separate package or manual-copy procedure. DOCA SDK must still be installed on Linux, with 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-compress" ~/.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:

  • How do I offload this gzip compression task on BlueField with doca_compress?
  • Why does doca_compress_task_compress_deflate return DOCA_ERROR_NOT_PERMITTED?

After installation, ask the agent an in-scope question such as: “How do I offload this gzip compression task on BlueField with doca_compress?” or “Why does doca_compress_task_compress_deflate return DOCA_ERROR_NOT_PERMITTED?” For configure, build, modify, run, test, or debug workflows, load TASKS.md. For capability and path-selection questions, load CAPABILITIES.md. If DOCA is not installed, use doca-setup first.

What are this skill's strengths and limitations?

Pros
  • Covers practical task configuration, capability discovery, permissions, buffer sizing, and error diagnosis.
  • Clearly defines the supported scope: bidirectional DEFLATE and LZ4 decompression, with LZ4 encoding excluded.
  • Provides language-neutral guidance for C/C++ and FFI-based consumers.
  • Includes round-trip smoke validation and progress-engine completion guidance.
Limitations
  • Requires a pre-existing DOCA SDK installation and BlueField DPU or ConnectX hardware.
  • Excludes DOCA installation, DOCA Core lifecycle internals, and other compression algorithms.
  • Ships no application source, language bindings, sample subtree, test fixtures, or standalone build manifest.
  • The supplied source gives no concrete device-model matrix, numeric version matrix, or performance benchmarks.

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 Compress Hardware Offload this page ✓ NVIDIA · Official 58 · Recommended ★ 3.8k today Apache-2.0
DOCA AES-GCM Acceleration ✓ NVIDIA · Official 57 · 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 Flow Tune ✓ NVIDIA · Official 54 · 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 compares DOCA Compress with CPU zlib/zstd for bulk-input path selection. LZ4 encoding should use a CPU LZ4 library, while pure mmap-to-mmap copying belongs to doca-dma.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Recommended
58/ 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.
1Trust20 / 25 · 4.0/5

The documentation makes source/destination mmap permissions, capability discovery, user confirmation, data-flow direction, rollback, and task draining explicit, and states that credentials are not required; the main safety risks are visible. Deducted 5 points because dependency security, hardware privilege boundaries, and external-effect controls remain incomplete, while some capability claims lack independent evidence within the assessed path.

2Reliability8 / 20 · 2.0/5

The configure/build/run/test/debug/rollback workflows are detailed and include error classification, progress-engine handling, and escalation routes. Deducted 12 points because key paths were not executed in this static review; LZ4 support is described inconsistently across SKILL.md, CAPABILITIES.md, and the skill card, and several conclusions depend on unavailable companion skills or local installation state.

3Adaptability11 / 15 · 3.7/5

Audience, trigger phrases, task inputs, non-fit ranges, DEFLATE/LZ4 directionality, and CPU fallbacks are clearly described. Deducted 4 points because the material is almost entirely English, Chinese interaction quality is not demonstrated, and the Linux/local DOCA/BlueField-or-ConnectX prerequisites plus mainland-China network reachability have limited evidence.

4Convention9 / 15 · 3.0/5

The SKILL.md loader, CAPABILITIES.md, and TASKS.md provide layered documentation with examples, dependencies, version checks, maintenance contacts, licensing, and evaluation material. Deducted 6 points for no clear author or changelog, inconsistencies between the skill-card license/repository metadata and the assessed material, TBD signature/version fields, and benchmark findings for missing recommended sections.

5Effectiveness6 / 15 · 2.0/5

It can directly guide capability discovery, permission setup, buffer sizing, round-trip smoke validation, debugging, and rollback, while clearly stating that it does not ship buildable implementation code. Deducted 9 points because no implementation, fixtures, or independently reproducible tests are included; the modification renderer is deferred, leaving users to manually compare local samples, so result completeness is only partly supported.

6Verifiability4 / 10 · 2.0/5

The assessed path contains concrete APIs, commands, error mappings, evaluation assertions, and a benchmark report, providing some auditability. Deducted 6 points because the evaluation dataset is unavailable, the report provides no committed test suite or CI evidence covering key paths, and many DOCA behavior claims cannot be independently cross-checked from these files alone.

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 install DOCA for me?
No. It assumes DOCA is already installed at /opt/mellanox/doca and routes installation work to doca-setup.
Does it support LZ4 compression?
No. It covers LZ4 stream and block decompression, while LZ4 encoding must use a CPU LZ4 library.
What input sizes are suitable for offload?
Its rule of thumb is that bulk inputs of a few KiB or more are the intended fit; tiny one-shot inputs may favor CPU compression because of accelerator-transfer overhead.
What should I inspect when no completion arrives?
Check context lifecycle, advertised task support, source and destination buffer sizes, mmap permissions, and progress-engine completion events.

More skills from this repository

All from NVIDIA/skills

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 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 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 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 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 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 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 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
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 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 SHA OpenSSL Offload Engine

Adds DOCA SHA hardware acceleration to existing OpenSSL pipelines without rewriting the application around the doca-sha C API.

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

DOCA PCC Custom Congestion Control

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

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

NVIDIA DOCA Flow Development Skill

Build, validate, and debug DOCA Flow packet-steering applications on supported NVIDIA NICs and DPUs.

★ 3.8k FS 49 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 Flow DPA Performance

Guides defensible measurement of DOCA Flow rule-update and disable rates on DPA-capable NVIDIA hardware.

★ 3.8k FS 58 Recommended today

Related skills