compass-doctor

Diagnose COMPASS framework setup and training failures via automated environment validation checks.

125|14|Updated Feb 21, 2025
One-click install
npx skills add https://github.com/NVlabs/COMPASS --skill compass-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compass-doctor
Source: https://github.com/NVlabs/COMPASS/tree/main/.claude/skills/compass-doctor
Command: npx skills add https://github.com/NVlabs/COMPASS --skill compass-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nvidia-smi, torch, isaacsim, and includes scripts (resource) components.

What problem does it solve?

Users working with the COMPASS robotics mobility framework often encounter vague errors like training failing to start, unexpected crashes, or non-functional workflows with no clear root cause, leading to wasted time chasing symptoms instead of identifying the actual issue.

Core Features & Use Cases

  • Automated Environment Diagnostics: Runs parallel checks for container status, shell activation, GPU availability, required assets, and Isaac Sim initialization in seconds.
  • Flexible Check Modes: Supports quick health checks, deep Isaac Sim init validation, and individual checkpoint integrity verification.
  • Actionable Root Cause Reporting: Interprets diagnostic results to pinpoint the exact failure point and routes users to the correct specialized skill for fixes, without auto-modifying the environment.
  • Use Case: If a user reports "training won't start" with no error details, this skill runs a single diagnostic to identify if the root cause is a missing asset, unactivated shell, or GPU driver issue.

Quick Start

Use the compass-doctor skill to run a full diagnostic of your COMPASS environment and identify the root cause of any setup or training failures.

Frequently Asked Questions about compass-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my COMPASS reinforcement learning training fail to start without a specific error message?

COMPASS training failures often stem from environment issues like unactivated shells or missing assets. An automated diagnostic tool can validate your container status, GPU access, and Isaac Sim initialization to pinpoint the exact root cause.

How do I diagnose COMPASS setup and training issues?

To diagnose COMPASS setup issues, run an automated environment validation that performs parallel checks on container status, shell activation, GPU availability, and checkpoint integrity to identify the root cause of the failure.

Does the COMPASS diagnostic check verify Isaac Sim initialization and GPU access?

Yes, the COMPASS diagnostic check validates Isaac Sim initialization and GPU access. It runs parallel environment validation checks to ensure nvidia-smi and torch dependencies are functioning correctly for reinforcement learning workflows.

What is the best way to troubleshoot a non-functional COMPASS robotics workflow?

The best way to troubleshoot a non-functional COMPASS robotics workflow is to run a full environment diagnostic. This validates required asset availability and checkpoint integrity to identify the exact failure point without modifying your setup.

Can I use compass-doctor to automatically fix missing assets in my training environment?

No, compass-doctor cannot automatically fix missing assets or modify your environment. It diagnoses root causes of setup failures by validating asset availability and checkpoint integrity, then routes you to the correct specialized skill for fixes.