Automation & Ops ✓ NVIDIA · Official

DOCA Firefly Time-Synchronization Operations

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

53/ 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.6k
Last updated
13d ago
License
Apache-2.0
ptp-time-syncbluefielddoca-fireflyphc2sys
+2syncecontainer-operations

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.

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

How do you install this skill?

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.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • BlueField Arm
  • DOCA installed
  • BlueField OS container runtime
  • NVIDIA NGC
  • PTP-aware network path
  • host-side chrony, ptp4l, or phc2sys follower

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.

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

  • Firefly says it is synced, but the host clock still drifts—what should I check?

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.

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 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 Firefly Time-Synchronization Operations this page ✓ NVIDIA · Official 53 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Container Deployment ✓ NVIDIA · Official 52 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Argus Runtime Security Operations ✓ NVIDIA · Official 50 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA Capabilities Inspector ✓ NVIDIA · Official 56 · Use with care ★ 3.6k 13d ago Apache-2.0
DOCA PCC Diagnostic Counters ✓ NVIDIA · Official 56 · Use with care ★ 3.6k 13d ago Apache-2.0

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.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
53/ 100 5-point scale 2.7 / 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.
1Trust16 / 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.

2Reliability8 / 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.

3Adaptability11 / 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.

4Convention8 / 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.

5Effectiveness6 / 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.

6Verifiability4 / 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.

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

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.

★ 3.6k FS 57 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Container Deployment

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

★ 3.6k FS 52 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Argus Runtime Security Operations

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

★ 3.6k FS 50 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Hardware Telemetry Counter Reader

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

★ 3.6k FS 60 Recommended 13d ago
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.6k FS 58 Recommended 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Capabilities Inspector

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

★ 3.6k FS 56 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA PCC Diagnostic Counters

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

★ 3.6k FS 56 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Telemetry Utils

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

★ 3.6k FS 56 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Verbs Raw RDMA Control

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

★ 3.6k FS 56 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Management Service Operations

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

★ 3.6k FS 55 Use with care 13d ago
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.

★ 3.6k FS 55 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA STA Storage Target Acceleration

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

★ 3.6k FS 55 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Structured Tools Contract

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

★ 3.6k FS 55 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Telemetry Exporter Development

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

★ 3.6k FS 55 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Upgrade Control

Safely gate DOCA upgrades and rollbacks with explicit confirmation.

★ 3.6k FS 55 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA Bench Benchmarking Skill

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

★ 3.6k FS 54 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA CollectX Telemetry Deployment

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

★ 3.6k FS 54 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Flow Performance Measurement

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

★ 3.6k FS 54 Use with care 13d ago
Dev & Engineering ✓ NVIDIA · Official

DOCA Programming Guide

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

★ 3.6k FS 54 Use with care 13d ago
Automation & Ops ✓ NVIDIA · Official

DOCA BlueField Bare-Metal Deployment

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

★ 3.6k FS 53 Use with care 13d ago

Related skills