Skip to content
Skills Library
DevOps & cloud · Tool integration

nvfleetint

/nvfleetint

Query NVIDIA Fleet Intelligence with the nvfleetint CLI. Use for ad hoc questions about fleets, nodes, GPUs, node groups, compute zones, alerts, agent health, firmware, verification, inventory, errors, or authentication. For a fleet-wide HTML snapshot use fleet-health-report; for a single-node RCA/RCCA use node-rca-rcca.

Licence
Apache-2.0
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Query NVIDIA Fleet Intelligence with the nvfleetint CLI. Use for ad hoc questions about fleets, nodes, GPUs, node groups, compute zones, alerts, agent health, firmware, verification, inventory, errors, or authentication. For a fleet-wide HTML snapshot use fleet-health-report; for a single-node RCA/RCCA use node-rca-rcca.

Original author description

Query NVIDIA Fleet Intelligence with the nvfleetint CLI. Use for ad hoc questions about fleets, nodes, GPUs, node groups, compute zones, alerts, agent health, firmware, verification, inventory, errors, or authentication. For a fleet-wide HTML snapshot use fleet-health-report; for a single-node RCA/RCCA use node-rca-rcca.

How it works

  1. Method
  2. Choose a command
  3. Example
Original SKILL.md headings · 116 lines, 941 words
SKILL.md preview
---
name: nvfleetint
description: Query NVIDIA Fleet Intelligence with the nvfleetint CLI. Use for ad hoc questions about fleets, nodes, GPUs, node groups, compute zones, alerts, agent health, firmware, verification, inventory, errors, or authentication. For a fleet-wide HTML snapshot use fleet-health-report; for a single-node RCA/RCCA use node-rca-rcca.
---

# Query Fleet Intelligence

Use live `nvfleetint` JSON; never answer fleet-state questions from memory. Read [`references/cli-contract.md`](references/cli-contract.md) before querying. Read [`references/auth.md`](references/auth.md) only for setup/profile work.

## Method

1. Run the smallest server-filtered query that answers the question.
2. Use `--output json`; give the user prose, not command dumps.
3. For counts, use `--page-size 1` and read `.total`. For identities, add `--view basic`. Use `--all` only when every row is required.
4. Lead with the answer; add a small table only for comparisons/listings.
5. Never infer absent fields or mistake auth failure for no results.

## Choose a command

| Need | Command |
| --- | --- |
| Fleet totals/health/metrics | `overview` |
| Zones or node groups | `computezone list`, `nodegroup list` |
| Nodes/current detail | `node list`, `node describe <uuid>` |
| Node health history | `node health <uuid>` |
| Fleet alert records | `alert list` |
| Alert impact/investigation | `alert summary`, `alert node`, `alert describe`, `alert options` |
| Raw events/histogram | `event list`, `event buckets` |
| Customer tags | `tag list` |
| Inventory/error reports | `report inventory`, `report error` |
| Verify signed report | `report verify` |
| Filter/sort values a command accepts | `node options`, `nodegroup options`, `alert options`, `xidburst options` |

### Overview and inventory

```bash
nvfleetint overview --output json
nvfleetint overview --include-metrics=false --output json
nvfleetint computezone list --include-metrics=false --output json
nvfleetint computezone list --output json
nvfleetint nodegroup list --compute-zone-ids <zone-id> --health Degraded,Unhealthy --output json
nvfleetint nodegroup list --gpu-type H100 --sort-by health --order desc --output json
```

`overview` is one non-paginated object. Use lists for rows behind its counts.

### Nodes

```bash
nvfleetint node list --agent-type inband --health Degraded,Unhealthy --output json
nvfleetint node list --agent-type inband --agent-status Offline --output json
nvfleetint node list --agent-type inband --hostname gpu-node-7 --view basic --output json
nvfleetint node list --agent-type inband --compute-zone-names ord --output json
nvfleetint node list --agent-type inband --nodegroup-names training --output json
nvfleetint node list --agent-type oob --bmc-hostname bmc-01 --output json
nvfleetint node describe <node-uuid> --output json
nvfleetint node describe <node-uuid> --agent-type oob --output json
nvfleetint node health <node-uuid> --start <rfc3339> --end <rfc3339> --output json
```

Ask users for human-readable zone/group names, never IDs. Name filters are comma-separated partial matches. For exact scope, resolve with `computezone list --view basic` or `nodegroup list --view basic`, clarify ambiguous names with recognizable detail metadata, then use IDs internally. Accept an ID already supplied by the user.

Detailed node list and describe query both agent views by default and return
`{inband: ..., oob: ...}` in JSON. Use `--agent-type inband|oob` when only one
view is needed; `node list` requires `--agent-type` whenever any filter or
`--sort-by`/`--order` flag is set, since in-band and OOB nodes carry different
fields. OOB list supports `--bmc-hostname`; OOB describe includes full
inventory JSON and supports table sections `managers`, `systems`, `chassis`,
and `firmware`. Node basic rejects health, agent, verification, and firmware
filters and supports sorting by `hostname`, `nodeUUID`, or `bmcHostname`.
`node health` requires both absolute boundaries. It does not support `--window`.

Filter values:

| Flag | Values |
| --- | --- |
| `--health` | Healthy, Degraded, Unhealthy, Unknown |
| `--agent-status` | Online, Offline, Unknown |
| `--verification-check` | Verified, Unverified, Degraded, Pending, Unsupported, Unknown |
| `--firmware-check` | Passed, Failed, Unknown |

Node sort keys are `hostname`, `nodeUUID`, `healthStatus`, `nodegroup`, `computezone`, `gpuType`, `gpuCount`, `verificationCheck`, `agentStatus`, `agentVersion`, `kernelVersion`, `gpuDriverVersion`, `gpuFirmwareVersions`, and `bmcHostname`. Node-group sort keys are `health` and `nodes`.

### Alerts and events

```bash
nvfleetint alert list --severity Critical --output json
nvfleetint alert list --node <node-uuid> --state Triggered --output json
nvfleetint alert summary --output json
nvfleetint alert summary --view historical --output json
nvfleetint alert node <node-uuid> --output json
nvfleetint alert node <node-uuid> --view historical --output json
nvfleetint alert describe <alert-uuid> --node <node-uuid> --output json
nvfleetint alert options --output json
nvfleetint event list --window 24h --output json
nvfleetint event buckets --window 168h --max-buckets 50 --output json
```

Alert severity is Critical/Warning; state is Detected/Triggered/Resolved. `alert summary`, `alert node`, and `alert options` default to the active view; use `--view historical` for history. Summary returns impacted nodes plus fleet-wide alert aggregates. Node returns alerts for one node. Describe returns one alert's event history. In node-alert results, Critical/Warning values are active severity; Detected/Resolved are inactive audit values. Don't count every non-Resolved row as active.

Events require `--window` or both `--start`/`--end`. Durations use Go units through hours—no `d`. Event list paginates; buckets do not.

### Tags and reports

```bash
nvfleetint tag list --prefix gpu --output json
nvfleetint tag list --computezone <zone-id> --output json
nvfleetint report inventory --compute-zone-ids <zone-id> --nodegroup-ids <group-id> --all --output json
nvfleetint report inventory --format csv --signed --output-path ./reports/
nvfleetint report error --view list --group-by error --window 168h --severities Critical,Fatal --output json
nvfleetint report error --view graph --window 24h --step 5m --output json
nvfleetint report verify --csv report.csv --bundle report.sig.bundle
```

Use at most one tag scope flag: `--node`, `--nodegroup`, or `--computezone`; tag list has no pagination. `tag set <node-uuid> --tags <list>` is the one command here that writes: it replaces a node's tags rather than adding to them, so run it only when the user asks for that change by name, pass `--yes`, and never use it to gather data. Report-error list requires `--group-by error|node`; only list supports `--all` and CSV. Signed inventory requires CSV. Report filters accept compute zone IDs, node group IDs, and tags; error reports also accept `--errors`, `--severities`, and graph-only `--step`.

## Example

For “Are any H100 nodes having problems?”, query H100 nodes filtered to Degraded/Unhealthy/Unknown. Include Unknown, read the filtered total, list only returned problem nodes, and do not claim the remaining H100 fleet is healthy without a separate query. Drill into requested UUIDs with `node describe` and node-scoped alerts.
Files in this package (4)
  • SKILL.md 7 KB
  • agents/openai.yaml 1 KB
  • references/auth.md 2 KB
  • references/cli-contract.md 5 KB

Versions

The database has no other skills named nvfleetint.

Database snapshot: 13.11.2026 · package version 91c325a0d311 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100fleet-health-report
    Generate a standalone fleet-wide HTML health snapshot from live nvfleetint data, including node health, capacity, active-alert impact, recent errors, and machines needing immediate attention. Use for fleet dashboards, executive summaries, or scoped fleet reports. Do not use for…
  • 100node-rca-rcca
    Investigate one NVIDIA Fleet Intelligence node and generate an evidence-backed HTML RCA/RCCA from live current and historical alerts plus authoritative corrective-action research. Use for node incident analysis, root-cause analysis, corrective actions, or post-incident reports.
  • 100pilot-fleet-health-monitor-setup
    Deploy a fleet health monitoring system with 3 agents. Use this skill when: 1. User wants to set up fleet or server health monitoring 2. User is configuring an agent as part of a health monitoring setup 3. User asks about monitoring, alerting, or metrics collection across agents…
  • 100remote-cluster-agent
    Remote GPU cluster ops via `rca` CLI — run commands, transfer files, GPU/node inspection, mutagen sync. Trigger for any remote execution, training, GPU, cluster status, sync, or tail-log task even when 'cluster' isn't said. Triggers: cluster, GPU, rca, training, node, sync code,…
  • 90esp32-ota-fleet-health-gate
    Use when designing, reviewing, debugging or validating ota fleet health gate for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release.
  • 90esp32-ota-fleet-version-skew
    Use when designing, reviewing, debugging or validating ota fleet version skew for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.