troubleshooting

par nvidia

Diagnostiquer et résoudre les problèmes courants, notamment les échecs de tests, les erreurs de compilation, les régressions de performance et les problèmes d'environnement de développement. Utilisez cette compétence…

npx skills add https://github.com/nvidia/elements --skill troubleshooting

Troubleshooting

You MUST review the troubleshooting guideline when diagnosing test failures, build errors, or performance issues.

When to Use This Skill

  • Debugging unit test failures or timing issues
  • Investigating visual regression test differences
  • Troubleshooting Lighthouse performance scores
  • Resolving build failures or Wireit cache issues
  • Fixing Git LFS problems with visual baselines
  • Diagnosing CI/CD pipeline failures
  • Resolving development environment setup issues
  • Investigating performance regressions in tests or builds

Must Read File

Read the troubleshooting guide to get critical context for troubleshooting guidance.

Diagnostic Triage Workflow

  1. Identify the symptom category:

    • Test failure:unit, axe, visual, SSR, or lighthouse?
    • Build failure:Wireit cache, dependency resolution, TypeScript, or circular imports?
    • Environment issue:Node version, pnpm version, Git LFS, or port conflict?
    • Performance regression:slow tests, slow builds, or large bundles?
  2. Run the relevant diagnostic commands:

    • Test failures: pnpm run test -- src/<component>/<component>.test.ts (isolate the failing test)
    • Build failures: pnpm run ci:reset then pnpm run build (clear caches first)
    • Environment: node --version && pnpm --version && git lfs env (verify toolchain)
  3. Check the matching section in the troubleshooting guide for the specific symptom/solution pair.

  4. If the issue persists, compare against a working reference component (badge, button, or card) to spot structural differences.

Additional References

Plus de skills de nvidia

compileiq-debug
nvidia
Utilisez quand quelque chose ne va pas : Search() bloque, toutes les évaluations retournent INVALID_SCORE, les scores ne s'améliorent pas, chaque configuration retourne le même nombre, erreurs ptxas…
create-github-pr
nvidia
Créer des pull requests GitHub en utilisant l'interface en ligne de commande gh. Utiliser lorsque l'utilisateur souhaite créer une nouvelle PR, soumettre du code pour révision, ou ouvrir une pull request. Mots-clés de déclenchement -…
nemoclaw-maintainer-cross-issue-sweep
nvidia
Analyse les autres problèmes ouverts pour trouver ceux qu’une PR donnée pourrait également corriger ou casser accidentellement. Génère des opportunités de correctifs adjacents et des risques de contradiction avec fichier:ligne…
fhir-basics
nvidia
Apprend aux agents comment fonctionnent les API FHIR R4, quelles ressources sont disponibles, comment les interroger avec des paramètres de recherche, et comment analyser correctement tous les formats de réponse…
compileiq-validate-result
nvidia
Utiliser APRÈS qu'une recherche soit terminée et AVANT de réclamer un accélérateur ou d'expédier un ACF. Charge le CSV dump_results, extrait les K meilleurs candidats (mono-objectif)…
changelog-audit
nvidia
Auditer le CHANGELOG.md de Warp avant une publication : récupérer les entrées perdues, trier par impact utilisateur, affiner le langage des entrées, ajuster les retours à la ligne et (en mode branche de publication) mettre à jour la comparaison…
maintain-dynamic-plugins
nvidia
Maintenir les chargeurs de plugins dynamiques NeMo Relay, les manifestes, les SDK natifs Rust, le protocole worker gRPC, le SDK worker Python, la documentation, les tests et la couverture du workflow de publication
dgx-diagnose
nvidia
Diagnostiquer les problèmes courants du DGX Station GB300 — plantages CUDA, ciblage incorrect du GPU, bugs de conteneur vLLM/SGLang, problèmes d'état MIG, erreurs NVLink/Fabric Manager,…