gabrielmoreira/agent-skills-mirror/doctor

Claude Code and agent skill by gabrielmoreira/agent-skills-mirror

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install gabrielmoreira/agent-skills-mirror/doctor

SKILL.md

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
workspaces, agents, or terminals inside a local workspace fails with "No cloud workspace … in this organization"the account has cloud workspaces, so these default to the cloud; add --local (or --host <id>)
An agent in a cloud workspace keeps an old sign-in after reconnecting Claude or Codexsuperset workspaces restart <id>; it ends every terminal and agent there, so ask first
A cloud workspace was archived by mistakesuperset workspaces unarchive <id>; within 7 days it keeps its disk, after that it starts fresh from its environment
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.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/gabrielmoreira/agent-skills-mirror/doctor/badge)](https://verified-skill.com/skills/gabrielmoreira/agent-skills-mirror/doctor)

Something wrong with this skill or its page? Tell us.