About superset-doctor
A troubleshooting skill for Superset that diagnoses service, authentication, host, and version problems before suggesting changes. It requires approval for state-changing fixes and escalates unresolved cases with collected evidence.
Key features
- 01Read-only health and version checks
- 02Known error signature matching
- 03Approval before state changes
- 04Verification after each fix
- 05Evidence-based issue escalation
Use cases
- 01Diagnosing a failed Superset sign-in
- 02Investigating an unreachable host
- 03Resolving service or version mismatch issues
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/superset-doctorin Claude Code to confirm it loaded.
Details
From the project READMESuperset 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 healthsuperset auth whoami— auth + active orgsuperset hosts list— host reachabilitysuperset --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.