---
name: Superset Doctor
slug: superset-doctor
category: DevOps
description: Superset Doctor diagnoses and fixes Superset problems such as connection failures, offline hosts, terminals not attaching, and auth or update issues. Use it when something in Superset itself is broken or misbehaving, before filing feedback.
github: "https://github.com/superset-sh/superset/tree/main/plugins/superset/skills/doctor"
language: TypeScript
stars: 12897
forks: 1190
install: "npx degit https://github.com/superset-sh/superset/tree/main/plugins/superset/skills/doctor ~/.claude/skills/doctor"
installs_to: ~/.claude/skills/doctor
source_path: plugins/superset/skills/doctor/SKILL.md
collection_size: 14
category_size: 798
collection_url: "https://dirskills.com/collections/superset-sh/superset"
added: 2026-08-14T07:13:25.953Z
last_synced: 2026-08-14T07:13:25.953Z
canonical_url: "https://dirskills.com/skills/superset-doctor"
---

# Superset Doctor

Superset Doctor diagnoses and fixes Superset problems such as connection failures, offline hosts, terminals not attaching, and auth or update issues. Use it when something in Superset itself is broken or misbehaving, before filing feedback.

**Install:**

```bash
npx degit https://github.com/superset-sh/superset/tree/main/plugins/superset/skills/doctor ~/.claude/skills/doctor
```

## README

# Superset Doctor

Diagnose first, change one thing at a time, verify after each change.

## 1. Snapshot (read-only, run in parallel, tolerate failures)

- `superset status` — host service health
- `superset auth whoami` — auth + active org
- `superset hosts list` — host reachability
- `superset --version`

## 2. Match known signatures

| Signature | Fix |
| --- | --- |
| `whoami` fails / session expired | `superset auth login` |
| Host shows offline | `superset hosts wake <id>`; confirm the machine is awake and online |
| Host service not running | `superset start` |
| CLI and desktop app version mismatch, or stale CLI | `superset update` |
| App-side misbehavior (macOS) | read the newest entries in `~/Library/Logs/Superset/main.log` for errors |

Propose the matching fix and get the user's go-ahead before running anything that changes state. Never delete data as a "fix".

## 3. Verify

Re-run the originally failing action. If it works, say exactly what was wrong and what fixed it.

## 4. Escalate with evidence

If unresolved, offer to file it via the `superset:feedback` skill — carry over the collected diagnostics (versions, status output, the relevant log excerpt) so the report arrives pre-triaged. Ask before including any log content; logs can contain paths and project names.