hermit-doctor

67 / 100 · Review before installing

Check before installing. Some of what it can do is expected: a coding skill usually runs build and test commands.

By gtapps/hermitd (GitHub) · coding · 84 stars · scanned at commit c2d971a

Runs the hermit's read-only health checks (runtime, config, hooks, state integrity, cost and spend, scheduling and watchdog, channels, credentials, permissions, docker, backup) and reports the summary. Use when diagnosing an install, before a release, or after suspicious behavior. Activates on messages like "/hermit-doctor", "health check", "diagnose the hermit", "what's wrong", "run diagnostic".

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

This is disclosed by the author in the skill's SKILL.md or README. Expected for a coding skill.

Found in 61 places.

plugins/hermitd/skills/hermit-doctor/SKILL.md, line 36bun ${CLAUDE_PLUGIN_ROOT}/scripts/doctor-check.ts .hermit
plugins/hermitd/skills/hermit-doctor/SKILL.md, line 86bun ${CLAUDE_PLUGIN_ROOT}/scripts/channel-send.ts .hermit --notice
plugins/hermitd/skills/hermit-doctor/SKILL.md, line 103bun ${CLAUDE_PLUGIN_ROOT}/scripts/doctor-check.ts .hermit --mark-notified <id> [<id>…]

Show 17 more

plugins/hermitd/scripts/browser-display.ts, line 4import { spawnSync } from 'node:child_process';
plugins/hermitd/scripts/browser-display.ts, line 126const children: ReturnType<typeof Bun.spawn>[] = [];
plugins/hermitd/scripts/browser-display.ts, line 142const xvnc = Bun.spawn(['Xvnc', owned.display, '-geometry', '500x1082', '-depth', '24', '-rfbport', '-1', '-rfbunixpath', vncSocket, '-rfbunixmode', '0600', '-S
plugins/hermitd/scripts/browser-display.ts, line 151children.push(Bun.spawn(['openbox'], { env, stdin: 'ignore', stdout: 'ignore', stderr: 'inherit' }));
plugins/hermitd/scripts/browser-display.ts, line 160const child = Bun.spawn([process.execPath, path.join(import.meta.dir, 'browser-viewer.ts')], { env: { ...env, HERMIT_BROWSER_VIEWER_BIND: browserDisplaySettings
plugins/hermitd/scripts/doctor-check.ts, line 12import { execFileSync } from 'node:child_process';
plugins/hermitd/scripts/doctor-check.ts, line 108version = execFileSync('bun', ['--version'], { encoding: 'utf8', timeout: 5000 }).trim();
plugins/hermitd/scripts/doctor-check.ts, line 638composeCfg = JSON.parse(execFileSync('docker', [
plugins/hermitd/scripts/doctor-check.ts, line 668const netNames = execFileSync('docker', ['network', 'ls', '--format', '{{.Name}}'],
plugins/hermitd/scripts/doctor-check.ts, line 676inspectOut = execFileSync('docker', ['network', 'inspect', net,
plugins/hermitd/scripts/doctor-check.ts, line 939const out = execFileSync(
plugins/hermitd/scripts/doctor-check.ts, line 1605: Bun.spawnSync(browserImageProbe(path.join(p.hermitDir, '../docker-compose.hermit.yml')), { timeout: 5000, stdout: 'ignore', stderr: 'ignore' }).exitCode === 0
plugins/hermitd/scripts/hermitd-start.ts, line 17import { spawnSync } from 'node:child_process';
plugins/hermitd/scripts/hermitd-start.ts, line 616const result = spawnSync('claude', ['plugin', 'marketplace', 'list', '--json'], {
plugins/hermitd/scripts/hermitd-start.ts, line 1097const r = spawnSync('bun', [script, target, op], { stdio: 'pipe', encoding: 'utf-8' });
plugins/hermitd/scripts/hermitd-start.ts, line 1135const r = spawnSync('bun', [script, '.claude/settings.local.json', 'voice-render'], { stdio: 'pipe', encoding: 'utf-8' });
plugins/hermitd/scripts/hermitd-start.ts, line 1317const res = spawnSync(cmd[0], cmd.slice(1), { stdio: 'inherit' });

and 41 more places

Downloads and installs other software

The author does not mention this.

Found in 3 places.

plugins/hermitd/scripts/doctor-check.ts, line 112detail: `bun not found — required${required ? ` (${required})` : ''}. Install: curl -fsSL https://bun.sh/install | bash`,
plugins/hermitd/scripts/hermitd-start.ts, line 415'bun: required runtime not on PATH. Install with `curl -fsSL https://bun.sh/install | bash`, ' +
plugins/hermitd/scripts/lib/transcription.ts, line 80if (platform !== 'linux') return { status: 'unsupported', reason: platform === 'darwin' ? 'brew install whisper-cpp ffmpeg' : `Unsupported platform: ${platform}

Sends data to these websites: bun.sh

The author does not mention this.

Found in 6 places.

plugins/hermitd/scripts/doctor-check.ts, line 112detail: `bun not found — required${required ? ` (${required})` : ''}. Install: curl -fsSL https://bun.sh/install | bash`,
plugins/hermitd/scripts/doctor-check.ts, line 1969const resp = await fetch(probe.url, { headers: probe.headers, signal: AbortSignal.timeout(LIVENESS_TIMEOUT_MS) });
plugins/hermitd/scripts/hermitd-start.ts, line 415'bun: required runtime not on PATH. Install with `curl -fsSL https://bun.sh/install | bash`, ' +

Show 3 more

plugins/hermitd/scripts/lib/channel-chats.ts, line 65const response = await fetch(`${base}${route}`, {
plugins/hermitd/scripts/lib/channel-chats.ts, line 152const response = await fetch(`${base}${route}`, {
plugins/hermitd/scripts/lib/channel-send.ts, line 107const resp = await fetch(url, { ...request, signal });

Reads your saved credentials, such as SSH keys or .env files

This is disclosed by the author in the skill's SKILL.md or README.

Found in 1 place.

plugins/hermitd/scripts/lib/backup.ts, line 228try { content = fs.readFileSync(path.join(root, '.env'), 'utf-8'); } catch { return null; }

Safer alternatives

Low-risk skills in the same category (coding) that look related. Check that one does what you need.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'hermit-doctor' ] || [ -L ~/.agents/skills/'hermit-doctor' ]; then echo 'A skill folder named hermit-doctor already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/gtapps/hermitd' "$d" && git -C "$d" checkout --quiet 'c2d971ab801daa0725f1554f92e405e62f76a3e8' -- 'plugins/hermitd/skills/hermit-doctor' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/hermitd/skills/hermit-doctor' ~/.agents/skills/'hermit-doctor' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'hermit-doctor' ~/.claude/skills/'hermit-doctor' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for gtapps/hermitd shows the score of its lowest-scoring skill.

SkillTrust badge for gtapps/hermitd

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/gtapps/hermitd.svg)](https://zalavijaysinh.github.io/skilltrust/repos/gtapps/hermitd/)

Score history

Date	Version	Score
2026-11-13	`c2d971a`	67
2026-11-09	`e69a48c`	67
2026-11-07	`84942b7`	67