jetson-diagnostic
Ce skill fait partie du catalogue officiel de skills AI agent publiés par NVIDIA dans le repository nvidia/skills. Son rôle est de fournir à un agent une vue unifiée et en lecture seule de l'état d'un appareil Jetson en cours d'exécution, en remplaçant la nécessité de connaître et combiner manuellement des outils comme tegrastats, jtop, nvpmodel, free, df ou systemctl.
Ce que fait ce skill
Lorsqu'il est activé, le skill guide l'agent pour exécuter des scripts shell (scripts/snapshot.sh, scripts/mem_summary.sh, scripts/detect_jetson.sh) qui collectent des données live sur le device : identité du SKU Jetson, consommation mémoire RAM et GPU, températures des zones thermiques, mode de puissance, occupation disque, processus les plus gourmands et état des services systemd. La sortie principale de snapshot.sh est un objet JSON structuré que l'agent peut analyser et résumer à l'utilisateur.
Le skill prend également en charge les différences de comportement entre familles Jetson : sur les variantes Orin (pilote nvgpu), nvidia-smi retourne des valeurs N/A et le skill bascule automatiquement sur /sys/kernel/debug/nvmap/iovmm/clients comme source autoritaire pour la mémoire GPU par processus. Sur la famille Thor, nvidia-smi est pleinement fonctionnel.
Périmètre et limites
Ce skill est strictement read-only : il n'applique aucun changement de configuration, ne modifie pas les modes de puissance, n'arrête aucun service et n'installe rien. Lorsque l'agent identifie un problème (surchauffe, mémoire saturée, services inutiles), il est censé passer la main à d'autres skills d'action comme jetson-memory-audit, jetson-headless-mode, jetson-inference-mem-tune ou jetson-llm-serve.
Le skill nécessite d'être exécuté sur le host Jetson ou dans un environnement disposant d'une visibilité sur les chemins système de la machine. Certaines données GPU (via NvMap debugfs) nécessitent des droits root ; en mode non privilégié, les champs correspondants seront null ou vides.
Installation et utilisation
Ce skill s'installe via la CLI skills comme n'importe quel skill du catalogue NVIDIA :
npx skills add nvidia/skills --skill jetson-diagnosticUne fois installé, l'agent l'active automatiquement lorsque l'utilisateur pose des questions relatives à l'état de son Jetson ("Pourquoi mon Jetson est-il lent ?", "Quel SKU est-ce ?", "Quels processus consomment de la mémoire GPU ?"). Les scripts sont invoqués via le placeholder {baseDir} si le runtime ne résout pas automatiquement les chemins relatifs au dossier du skill.