All skills
nvidia avatar

/doca-dpa-hl-tracer

@f64fa0e
by NVIDIA Corporationnvidia/skills3.5k stars
424

Use this skill when the user runs doca_dpa_hl_tracer to capture/decode DPA-side traces at the programming-events layer (kernel entry/exit, sync points, comm primitive calls, RDMA WR submission, completion drain) — picking TRACE vs CRIT, tuning the JSON config (file-size limits + file_size_limit_policy, thread priorities/cores), decoding against the matching DPA-side ELF, or diagnosing empty/noisy captures. Trigger even when the user does not explicitly mention "DOCA DPA tracer" or "high-level tracer" — typical implicit phrasings include "DPA kernel returns wrong result but host completions look clean", "kernel-entry to first-comm latency is huge", "RDMA WR to drain gap on the DPA", "trace file truncated mid-run", "TRACE doubled my DPA latency", or "tracer wrote a file but parser shows zero events". Refuse and route elsewhere for writing DPA kernels, DPA-Comms/DPA-Verbs programming, raw per-cycle DPA profiling, host-side doca-dpa debugging, or production DPA telemetry — those belong to other skills.

Use this Skill: https://skilld.dev/gh/nvidia/skills/doca-dpa-hl-tracer

This session only. Nothing lands on disk.

BENCHMARK.md

≈1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Evaluation Report

Evaluation of the doca-dpa-hl-tracer skill before publication through Skill Evaluator.

This benchmark summarizes 3-Tier Evaluation from Skill Evaluator results for the skill. The goal is to document whether the skill is safe, discoverable, effective, and useful for agents before it is published for broader workflow use.

Evaluation Summary

  • Skill: doca-dpa-hl-tracer
  • Evaluation date: 2026-07-26
  • Environment: k8s-sandbox
  • Dataset: 4 evaluation tasks
  • Attempts per task: 1
  • Pass threshold: 50%
  • Overall verdict: PASS

Agents Used

  • Claude Code (aws/anthropic/bedrock-claude-opus-4-8)
  • Codex (openai/openai/gpt-5.5)

Metrics Used

Reported benchmark dimensions:

  • Security: checks whether skill-assisted execution avoids unsafe behavior such as secret leakage, destructive commands, or unauthorized access.
  • Correctness: checks whether the agent follows the expected workflow and produces the correct final output.
  • Discoverability: checks whether the agent loads the skill when relevant and avoids using it when irrelevant.
  • Effectiveness: checks whether the agent performs measurably better with the skill than without it.
  • Efficiency: checks whether the agent uses fewer tokens and avoids redundant work.

Underlying evaluation signals used in this run:

  • security (Security): checks for unsafe operations, secret leakage, and unauthorized access.
  • skill_execution (Skill Execution): verifies that the agent loaded the expected skill and workflow.
  • skill_efficiency (Efficiency): checks routing quality, decoy avoidance, and redundant tool usage.
  • accuracy (Accuracy): grades final-answer correctness against the reference answer.
  • goal_accuracy (Goal Accuracy): checks whether the overall user task completed successfully.
  • behavior_check (Behavior Check): verifies expected behavior steps, including safety expectations.

Test Tasks

The benchmark dataset contained 4 evaluation tasks:

  • Positive tasks: 3 tasks where the skill was expected to activate.
  • Negative tasks: 1 tasks where no skill was expected.
  • Unlabeled tasks: 0 tasks where positive/negative intent could not be inferred.

Task composition is derived from the evaluation dataset when possible. Entries with expected_skill set are treated as positive skill-activation cases, while entries with expected_skill: null are treated as negative activation cases.

Results

Dimension Num Claude Code (aws/anthropic/bedrock-claude-opus-4-8) Codex (openai/openai/gpt-5.5)
Security 4 100% (+0%) 100% (+0%)
Correctness 4 100% (+45%) 100% (+40%)
Discoverability 4 100% (+26%) 95% (+38%)
Effectiveness 4 86% (+61%) 100% (+75%)
Efficiency 4 97% (+29%) 100% (+68%)

Score values show skill-assisted performance. Values in parentheses show uplift versus the no-skill baseline when baseline data is available.

Tier 1: Static Validation Summary

Tier 1 validation passed with observations. Skill Evaluator ran 1 checks and found 7 total findings.

Top findings:

  • MEDIUM SCHEMA/folder_hierarchy: Unexpected nesting depth for general skill (skills/tools/doca-dpa-hl-tracer)
  • MEDIUM SCHEMA/body_recommended_section: Missing recommended section: '## Instructions' (skills/tools/doca-dpa-hl-tracer/SKILL.md)
  • MEDIUM SCHEMA/body_recommended_section: Missing recommended section: '## Examples' (skills/tools/doca-dpa-hl-tracer/SKILL.md)
  • MEDIUM SCHEMA/author_missing: Author not specified in metadata (skills/tools/doca-dpa-hl-tracer/SKILL.md)
  • LOW SCHEMA/unexpected_file: Unexpected 'SKILLCARD.yaml' in skill root (skills/tools/doca-dpa-hl-tracer/SKILLCARD.yaml)

Tier 2: Deduplication Summary

This tier was not run or did not produce findings in this report.

Publication Recommendation

The skill is suitable to proceed toward Skill Evaluator publication based on this benchmark. Skill owners should keep this file with the skill and refresh it when the evaluation dataset, skill behavior, or target agents materially change.

Source: SKILL.md on GitHub

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides technical guidance and workflows for the NVIDIA doca_dpa_hl_tracer tool, used for capturing and analyzing DPA-side execution traces. The skill is instructional in nature and does not contain malicious code, remote dependencies, or obfuscated payloads. It correctly handles security considerations by advising users to treat trace files as sensitive artifacts and referring to official documentation for privilege requirements.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at f64fa0e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 months ago
metadata
{
  "kind": "tool"
}
Other metadata
compatibility
Requires DOCA SDK installed at /opt/mellanox/doca on Linux (Ubuntu 22.04/24.04 or RHEL/SLES) with a BlueField device whose DPA processor is exposed to the host, plus the DOCA DPA Tools optional component (binary at /opt/mellanox/doca/tools/doca_dpa_hl_tracer). Requires a DPACC-built DPA-side ELF and a live doca-dpa-launched workload for events to fire.

README badge

README badge for nvidia/skills/doca-dpa-hl-tracer