troubleshooting

작성자: nvidia

테스트 실패, 빌드 오류, 성능 회귀, 개발 환경 문제 등 일반적인 문제를 진단하고 해결합니다. 이 스킬을 사용하여…

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.

References

nvidia의 다른 스킬

fhir-basics
nvidia
에이전트에게 FHIR R4 API의 작동 방식, 사용 가능한 리소스, 검색 매개변수를 사용한 쿼리 방법, 모든 응답 형식을 올바르게 파싱하는 방법을 가르칩니다…
compileiq-validate-result
nvidia
검색이 완료된 후, 속도 향상을 청구하거나 ACF를 발송하기 전에 사용합니다. dump_results CSV를 로드하고, 상위 K개 후보(단일 목표)를 추출합니다…
changelog-audit
nvidia
릴리스 전에 Warp CHANGELOG.md를 감사합니다: 누락된 항목 복구, 사용자 영향별 정렬, 항목 언어 다듬기, 줄 바꿈, (릴리스 브랜치 모드) 비교 업데이트…
dgx-diagnose
nvidia
일반적인 DGX Station GB300 문제 진단 — CUDA 충돌, 잘못된 GPU 타겟팅, vLLM/SGLang 컨테이너 버그, MIG 상태 문제, NVLink/Fabric Manager 오류,…
aicr-managing-openvex
nvidia
Use when adding, updating, or removing CVE/GHSA suppressions in `.openvex.json` — the OpenVEX document consumed by the daily image vulnerability scan workflow.…
aicr-creating-slide-decks
nvidia
기술 개념이나 워크플로우에 대한 독립형 HTML 슬라이드 덱 또는 시각적 발표 자료(예: demos/*.html)를 만들 때 사용하세요. 전체 화면으로 표시하거나…
aicr-creating-guided-demos
nvidia
대화형 안내 데모 스크립트(demos/*.sh)를 라이브 또는 자기 주도 방식으로 Frame → Tell → Show → Close 패턴에 따라 구조화한다. "데모 스크립트", "안내…"와 같은 표현에 반응한다.
aicr-analyzing-snapshots
nvidia
AICR 스냅샷 YAML 파일을 분석하거나, 클러스터 상태를 검토하거나, 공급자 특성을 비교하거나, GPU/네트워크 토폴로지 인사이트를 추출할 때 사용합니다...