Automation & Ops ✓ NVIDIA · Official ptp-time-syncbluefielddoca-fireflyphc2syssyncecontainer-operations

DOCA Firefly Time-Synchronization Operations

Operate, configure, and troubleshoot DOCA Firefly PTP time synchronization on BlueField.

FollowSkills review · FSRS-2.0
Not recommended
53/ 100 5-point scale 2.7 / 5
Trust16 / 25 · 3.2/5

The material scopes the skill to BlueField Arm, a container, selected interfaces, and paired workloads; it requires deciding whether PTP is needed, emphasizes the end-to-end clock chain, prohibits speculative deployment, and shows no malware, credential theft, or covert exfiltration. Points are deducted because PHC, host-clock, container, and network changes can have external effects without an explicit confirmation gate, least-privilege checklist, or complete rollback procedure. License and provenance metadata also conflict across the supplied files.

Reliability8 / 20 · 2.0/5

SKILL.md, CAPABILITIES.md, and TASKS.md provide a generally coherent configure, run, test, and layered-debug workflow with symptom-to-owner mapping. Points are deducted because this is static-only review with no executed reproduction, no committed executable deployment configuration or complete key-path test suite, and substantial dependence on external documentation. The six-subsystem statement is contradicted by a later reference to all five subsystems, and the supplied TASKS evidence is truncated at the end.

Adaptability11 / 15 · 3.7/5

Audience, positive triggers, implicit examples, and non-fit boundaries are unusually explicit, and the material separates Firefly from the host follower, consumer workload, and other DOCA skills. Points are deducted because Chinese-language support is not documented, mainland-China reachability of NGC and public documentation is unverified, and deployment compatibility still depends on user-specific versions, runtimes, and PTP topology.

Convention8 / 15 · 2.7/5

The layered SKILL.md, CAPABILITIES.md, TASKS.md, benchmark, and skill-card structure supports progressive disclosure and includes version guidance, related skills, limitations, maintenance contacts, and evaluation material. Points are deducted for missing recommended Instructions and Examples sections, unresolved schema findings in the benchmark, TBD signature/version fields, inconsistent repository/license declarations, and no clear changelog or stable maintenance commitment.

Effectiveness6 / 15 · 2.0/5

The skill offers directly useful decision and troubleshooting flows for determining whether Firefly is needed, selecting PTP axes, diagnosing host-clock drift, and isolating failures by layer. Points are deducted because it intentionally omits image tags, complete configuration files, exact deployment commands, and host-follower configuration, requiring external guides and other skills. Static evidence therefore does not establish directly usable completion of the operator's task.

Verifiability4 / 10 · 2.0/5

The files identify a public DOCA Firefly Service Guide, name concrete symbols and command classes, and include an internal benchmark report. Points are deducted because the public source URL is not supplied directly, the benchmark dataset is unavailable and cannot be reproduced here, and no inspectable CI workflow, committed test suite, or independent corroboration covers the key paths.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 55f18499943e
Before you use it
  • Do not treat the internal benchmark PASS result or NVIDIA identity as a substitute for evidence of this skill's reliability, safety, or effectiveness.
  • Before deployment, verify the version-matched official Firefly guide, image tag, configuration schema, permissions, and host follower; the supplied files contain subsystem-count and license/provenance inconsistencies.
  • Obtain confirmation before changes affecting the PHC, host clock, PTP interface, or network path, and prepare verifiable recovery steps.
Review evidence [1][2][3][4][5][6][7][8][9]
See the full review method →

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

This skill is for external operators and platform teams running the DOCA Firefly Service container on BlueField Arm. It helps choose the PTP role, profile, domain, and interface, then connect the BlueField PHC to a host-side follower and a timing-sensitive workload. It covers Firefly’s PTP, PTP Monitor, internal PHC2SYS, PPS, SyncE, and Firefly Servo subsystems, along with observability and troubleshooting. Firefly is a poor fit when chrony or NTP already meets the workload’s precision budget or when the network path is not PTP-aware.

Guides installation from the NVIDIA skills collection; assesses whether PTP-grade time is needed; configures and operates the Firefly container on BlueField Arm; checks configuration files, environment variables, container logs, PHC offset, and port state; diagnoses role, profile, domain, interface, host-follower, PTP-path, and container-runtime problems; and explains pairing Firefly with Rivermax SMPTE workloads.

  1. A BlueField platform team needs PTP-grade time for a Rivermax SMPTE ST 2110 workload.
  2. An operator has a healthy Firefly container whose PTP state remains LISTENING.
  3. Firefly reports synchronization, but the host clock continues to drift.
  4. PTP is locked, but offset or jitter is in the tens of microseconds.
  5. A team is deciding whether existing chrony/NTP is sufficient for a distributed database, 5G UPF, or financial workload.

What are this skill's strengths and limitations?

Pros
  • Covers six Firefly PTP-stack subsystems instead of treating Firefly as only a PTP daemon.
  • Clearly separates Firefly, the BlueField PHC, the host-side follower, and the consumer workload.
  • Organizes deployment and debugging around role, profile, domain, and interface decisions.
  • Explicitly routes users away when chrony/NTP is sufficient or the path lacks PTP support.
Limitations
  • Requires DOCA, BlueField Arm, a container runtime, and a PTP-aware network path.
  • Does not ship production-ready Firefly configuration files, image tags, or host-side time-sync configuration bodies.
  • Does not replace DOCA installation, PTP topology design, host chrony/ptp4l configuration, or application-development guidance.

How do you install this skill?

Install it from the NVIDIA skills collection with: npx skills add nvidia/skills --skill doca-firefly --yes. The source does not require a separate manual folder-copy procedure.

How do you use this skill?

Load the skill in an Agent Skills-compatible client and ask a concrete operations question, such as: “Firefly says it is synced, but the host clock still drifts—what should I check?” Before deployment, confirm that DOCA is installed on BlueField Arm and prepare the Firefly configuration, a reachable PTP master or master role, a PTP-aware network path, and a host-side time follower. The source does not provide exact container image tags, complete configuration blocks, or host chrony/ptp4l/phc2sys configuration bodies.

How does this skill compare with similar options?

The skill compares Firefly with host-side NTP/chrony for path selection: keep the existing NTP/chrony setup when it meets the workload’s precision budget; consider Firefly when PTP-grade precision is required.

FAQ

Is Firefly the host time follower?
No. Firefly drives and observes the BlueField PHC; the operator must separately configure chrony, ptp4l, or phc2sys on the host to read that PHC.
What environment is required?
The source assumes BlueField Arm with DOCA installed, the BlueField OS container runtime, privileges to pull, run, and configure containers, and a reachable PTP master—or operation as the master itself.
Does the skill include complete configuration templates?
No. It provides configuration decisions and workflows, but deliberately excludes production PTP files, image tags, and host-side synchronization configuration bodies.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

DOCA Environment Setup

Verify, prepare, and troubleshoot the DOCA environment while routing workloads to the right deployment path.

Automation & Ops ✓ NVIDIA · Official

DOCA Container Deployment

Deploy, validate, and troubleshoot DOCA service containers on NVIDIA BlueField.

Automation & Ops ✓ NVIDIA · Official

DOCA Argus Runtime Security Operations

Deploy Argus on BlueField to detect runtime threats and forward findings to an existing SIEM.

Dev & Engineering ✓ NVIDIA · Official

DOCA Hardware Telemetry Counter Reader

Guides developers in reading per-domain hardware counters from BlueField and ConnectX devices.

Dev & Engineering ✓ NVIDIA · Official

DOCA Flow DPA Performance

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

Automation & Ops ✓ NVIDIA · Official

DOCA Capabilities Inspector

Inspect what DOCA can see on a host through a read-only device and capability CLI.

Automation & Ops ✓ NVIDIA · Official

DOCA PCC Diagnostic Counters

Read fixed firmware and hardware PCC congestion diagnostics on ConnectX and BlueField devices.

Automation & Ops ✓ NVIDIA · Official

DOCA Telemetry Utils

Discover telemetry counters, translate Data IDs, and verify BlueField support before committing exporter configuration.

Dev & Engineering ✓ NVIDIA · Official

DOCA Verbs Raw RDMA Control

Guides DOCA developers who genuinely need low-level verbs control, porting, and diagnosis.

Automation & Ops ✓ NVIDIA · Official

DOCA Management Service Operations

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

Dev & Engineering ✓ NVIDIA · Official

DOCA GPUNetIO Development Skill

Helps developers connect CUDA kernels on NVIDIA GPUs to DOCA network queues for GPU-side packet I/O and debugging.

Dev & Engineering ✓ NVIDIA · Official

DOCA STA Storage Target Acceleration

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

Automation & Ops ✓ NVIDIA · Official

DOCA Structured Tools Contract

A governed fallback contract for consolidating DOCA environment, device, capability, validation, and host-DPU state data.

Dev & Engineering ✓ NVIDIA · Official

DOCA Telemetry Exporter Development

Guides DOCA applications in defining, emitting, and debugging structured telemetry for external consumers.

Automation & Ops ✓ NVIDIA · Official

DOCA Upgrade Control

Safely gate DOCA upgrades and rollbacks with explicit confirmation.

Automation & Ops ✓ NVIDIA · Official

DOCA Bench Benchmarking Skill

Measure DOCA library throughput, latency, and bandwidth reproducibly on real NVIDIA networking hardware.

Automation & Ops ✓ NVIDIA · Official

DOCA CollectX Telemetry Deployment

Deploy, operate, and debug CollectX telemetry collectors so counters reach downstream exporters.

Dev & Engineering ✓ NVIDIA · Official

DOCA Flow Performance Measurement

Guides reproducible, defensible measurements of host-side and DPU-CPU DOCA Flow control-plane rule rates.

Dev & Engineering ✓ NVIDIA · Official

DOCA Programming Guide

Guides developers through building, testing, and debugging library-agnostic DOCA applications from shipped samples.

Automation & Ops ✓ NVIDIA · Official

DOCA BlueField Bare-Metal Deployment

Run, supervise, and troubleshoot DOCA binaries directly on BlueField hardware.

Related skills