How do I install the Doctor skill?

Run npx skillmds@latest add superset-sh/doctor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Doctor safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Doctor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Doctor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Doctor?

superset-sh (@superset-sh) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Doctor by superset-sh — Agent Skill

Name: Doctor
Rating: 4.2 (5 reviews)
Author: superset-sh

Doctor

Diagnose and fix Superset problems such as connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself ("Superset won't connect", "my host shows offline", "terminal won't attach", "the app is stuck"), before filing feedback.

superset-sh Updated Sep 9, 2026

File contents

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 for host service health
superset auth whoami for auth and the active org
superset hosts list for 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 with the feedback skill and 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.

Frequently asked questions