/doctor
Diagnose and fix Superset problems — connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself, before filing feedback.
$ npx -y skills add superset-sh/superset --skill doctor --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/doctor
Context preview
The summary Claude sees to decide when to auto-load this skill.
Diagnose and fix Superset problems — connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself, before filing feedback.
SKILL.md
doctor.SKILL.mdname: doctor
description: Diagnose and fix Superset problems — connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself, before filing feedback.
argument-hint: describe the symptom
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.
Read more
name: doctor description: Diagnose and fix Superset problems — connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself, before filing feedback. argument-hint: describe the symptom
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.
Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
Other skills on superset.
- /10x
Personalized audit that teaches advanced Superset features the user isn't using yet — automations, parallel agents, tasks, multi-host, terminals, custom commands, MCP. Use when the user wants to get more out of Superset, learn advanced Superset features, or 10x their Superset
Open skill - /automate
Turn a recurring chore into a Superset automation — drafts the agent prompt, confirms schedule and target, creates it with the CLI, and reviews the first run together. Use when the user wants a scheduled or recurring agent, a daily/weekly job, or to automate a repeating task
Open skill - /contribute
Set up a Superset open-source contribution — fork and clone superset-sh/superset, run local dev setup, and follow the repo's contribution rules through to a merge-ready PR. Use when the user wants to contribute to Superset, fix a Superset bug themselves, or prepare a PR against
Open skill - /feedback
Collect and submit feedback about Superset — bug reports, feature requests, or general feedback — privately to the Superset team or as a public GitHub issue. Use when the user wants to report a Superset bug, request a feature, or send feedback about Superset.
Open skill - /orchestrate
Coordinate multiple terminal coding agents through the Superset CLI by creating isolated workspaces, launching workers, sending follow-ups, reading terminal output, tracking dependencies, and collecting structured results. Use when asked to delegate or parallelize coding work,
Open skill - /setup
Make a repository Superset-ready — author .superset/config.json with setup/teardown/run scripts so every new workspace boots configured, then verify with a real workspace. Use when the user wants to set up a project or repo for Superset, configure workspace setup scripts, or fix
Open skill