Skip to content
cccskills
FreePublished on GitHubEnglish overview

doctor

Diagnose Superset connection, host, terminal, authentication, and update problems using status checks and logs. Get a matching fix, approve changes before they run, and verify whether the original problem is resolved.

OriginalShow the original description

Diagnose and fix Paradev (formerly 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 Paradev itself ("Paradev won't connect", "my host shows offline", "terminal won't attach", "the app is stuck"), before filing feedback.

ParadevAI/Paradev15,720 stars(GitHub 15,720 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Investigating a Superset connection failure
  • Recovering an offline host
  • Checking terminal attachment problems
  • Diagnosing authentication or version issues

Overview

What it does

Diagnose problems in Superset and suggest a fix that matches the symptoms. Check host service status, the signed-in account and organization, host connectivity, and the CLI version, then compare the results with known issues. This can help distinguish expired authentication, a stopped service, failed host setup, or a mismatch between the CLI and desktop app. After an approved change, retry the original action to check the result.

When it helps

Use this skill when Superset will not connect, a host appears offline, a terminal will not attach, or you suspect an authentication or update problem. If the issue remains unresolved, it can suggest handing the collected diagnostic results to a feedback report.

Example requests

  • “Find out why my Superset host is offline.”
  • “The terminal will not connect. Check its status and authentication.”
  • “Diagnose any update or version problems.”

Notes

The skill uses the superset CLI. It asks for your approval before running commands that change state, and checks the original action again afterward. Adding a host over SSH supports macOS and x64 or arm64 glibc Linux; curl is required. Alpine and Windows are not supported. It also asks before including log content in a report.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt requires approval for state changes and log sharing, and forbids deletion as a fix.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt requires the `superset` CLI and documents supported SSH host systems and `curl`.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 29, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (2)

  • SKILL.md2.9 KB
  • agents/openai.yaml228 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Paradev Doctor

paradev is an alias for the superset CLI: every superset command here also runs as paradev.

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

SignatureFix
whoami fails / session expiredsuperset auth login
Host shows offlinesuperset hosts wake <id>; confirm the machine is awake and online
Host service not runningsuperset start
A host set up with superset hosts add is offline or brokenre-run superset hosts add <ssh-target>; it checks each step and fixes only what is wrong. On Linux its log is ssh <ssh-target> journalctl --user -u superset-host -n 50
hosts add cannot reach or set up the machineconfirm ssh <ssh-target> works from here, the remote is macOS or glibc Linux (x64 or arm64; Alpine and Windows are not supported), and it has curl
Private repos will not clone on a host added with hosts addsign in GitHub there: ssh -t <ssh-target> gh auth login (install gh first if missing)
Linux host stops when the user logs out of itenable lingering on that machine: loginctl enable-linger
hosts add stops on an empty or invalid /etc/machine-id (cloned VM or container image)on that machine, sudo rm -f /etc/machine-id && sudo systemd-machine-id-setup, then re-run hosts add. The user runs this, since it needs sudo on their box
superset pages publish in a Paradev terminal fails with "Not a member of organization"superset update; newer CLIs use the desktop app's account inside its terminals
CLI and desktop app version mismatch, or stale CLIsuperset 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

10x

FreeSummary

Review how you use Superset and identify unused features that fit your workflow. Get a short list of suggestions, learn about each option, and set up selected features such as scheduled agents, parallel workspaces, or shared tasks.

  • Find unused Superset features worth exploring
  • Set up scheduled agent tasks
  • Start parallel work in separate workspaces
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

automate

FreeSummary

Set up recurring tasks in Superset with an agent prompt, a schedule or event trigger, and a chosen execution workspace. After explicit confirmation, create the automation, check its saved settings, and review a real first run.

  • Scheduling a daily or weekly agent task
  • Starting agent work when a GitHub pull request opens
  • Triggering tasks from selected Slack reactions
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

browser

FreeSummary

Browse pages, click controls, fill fields, and inspect screenshots or console messages through Superset's browser pane. Use it to preview a running web app, check interface behavior, and work through browser tasks in a visible session.

  • Preview a locally running web app
  • Capture screenshots of a page
  • Inspect console errors
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

Build Stripe payments, subscriptions, and invoicing using verified documentation and API parameter definitions. The skill guides product selection, sandbox testing, and webhook handling, where server notifications determine payment and subscription state.

  • Choose Stripe products for payments or recurring billing
  • Implement Checkout or invoice flows
  • Investigate Stripe code that compiles but behaves incorrectly
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

cdp-verification

FreeSummary

Verify a UI change or reproduce a bug in the running desktop app using the Chrome DevTools Protocol (CDP), a browser debugging interface. Follow the real user journey and compare screenshots with measurements such as route, scroll position, and persisted state.

  • Reproducing a UI bug in the running app
  • Verifying a UI change end to end
  • Checking behavior after a route or workspace switch
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

ci-triage

FreeSummary

Diagnose failed GitHub Actions runs by finding the first meaningful error, separating code problems from infrastructure issues and intermittent failures, and comparing the base branch. Get a focused report explaining the PR’s involvement and recommended next steps.

  • Investigating failed PR checks
  • Separating intermittent test failures from code defects
  • Checking whether the base branch already fails
ParadevAI/Paradev15.7KUpdated Oct 29, 2026

See all skills by ParadevAI

Report a problem with this skill