ssh-doctor — скилл для Claude Code: что делает и как установить
Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login.
MIT 239 установок ★ 7 554 обновлён 2026-10-20
npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-codeЧто делает ssh-doctor
Скилл проверяет серверную часть SSH на macOS по чёткому алгоритму. Сначала агент тестирует loopback-соединение через 127.0.0.1 на 22 порту, чтобы отделить сбои демона от сетевых фильтров. Если локальный вход работает, проверяются правила файрвола через socketfilterfw и pfctl, а также привязка сетевых интерфейсов.
При ошибках до авторизации скилл ищет зависшие процессы sshd-session, привязавшиеся к PID 1. При высоком значении copy count в launchd сервис перестаёт порождать новые копии inetd с ошибкой Too many processes. Скилл находит такие сессии через ps и lsof, после чего аккуратно завершает их сигналами TERM или KILL.
Для работы на целевой машине потребуются права sudo: проверки запускают launchctl, systemsetup и чтение системного журнала. Скилл также следит за секретами и не выводит токены или переменные окружения в консоль.
Какие задачи решает
- устранить сброс SSH-соединения до авторизации на macOS
- найти и завершить зависшие процессы sshd-session
- проверить статус Remote Login и перезапустить службу com.openssh.sshd
- выявить блокирующие директивы AllowUsers и MaxStartups в sshd_config
Примеры запросов агенту
- Запусти диагностику SSH на этом Маке, подключение сбрасывается до ввода пароля.
- Проверь зависшие сессии sshd и состояние службы Remote Login.
- Посмотри ошибки com.openssh.sshd в системном логе и перезапусти сервис.
Как установить ssh-doctor
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-code2Вручную: положить файлы
~/.claude/skills/ssh-doctor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ssh-doctor/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill ssh-doctor -a codex2Вручную: положить файлы
.agents/skills/ssh-doctor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill ssh-doctor -a cursor2Вручную: положить файлы
.cursor/skills/ssh-doctor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install steipete/agent-scripts skills/ssh-doctor2Вручную: положить файлы
.github/skills/ssh-doctor/SKILL.md1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill ssh-doctor -a gemini-cli2Командой платформы
gemini skills install https://github.com/steipete/agent-scripts --path skills/ssh-doctorВручную: положить файлы
.devin/skills/ssh-doctor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill ssh-doctor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ssh-doctor
Как установить ssh-doctor в Claude Code?
Выполните команду npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-code. Либо сохраните файл по пути ~/.claude/skills/ssh-doctor/SKILL.md.
Что делает скилл ssh-doctor?
Он выполняет пошаговую диагностику SSH-сервера на macOS. Скилл проверяет loopback, инспектирует настройки sshd_config, отслеживает ошибки launchd и находит зависшие процессы сессий.
Как скилл устраняет ошибку inetd Too many processes?
Скилл инспектирует launchctl print system/com.openssh.sshd и выявляет брошенные процессы sshd-session. Затем он завершает их сигналом TERM, освобождая лимит процессов для новых подключений.
Исходный текст
SKILL.md · MIT
--- name: ssh-doctor description: "SSH triage: Remote Login, launchd sshd, pre-auth closes, stale sessions." --- # SSH Doctor Use when SSH connects then closes before auth, Remote Login seems advertised but unusable, or local/remote Mac SSH needs diagnosis. ## Rules - Do not print secrets, tokens, full env, or broad secret grep output. - Validate locally first: loopback failure means server-side sshd/launchd/config; loopback success plus remote failure means network/firewall/filter/listen path. - Report suspicious config lines before changing `/etc/ssh/sshd_config`. - Prefer non-interactive SSH: ```bash ssh -o RequestTTY=no -o RemoteCommand=none HOST 'hostname; id -un' ``` ## Baseline ```bash hostname; id -un; sw_vers ipconfig getifaddr en0 ipconfig getifaddr en1 2>/dev/null || true ipconfig getifaddr en7 2>/dev/null || true sudo systemsetup -getremotelogin sudo systemsetup -setremotelogin on sudo launchctl print system/com.openssh.sshd 2>&1 | head -80 sudo launchctl kickstart -k system/com.openssh.sshd sudo lsof -nP -iTCP:22 -sTCP:LISTEN nc -vz 127.0.0.1 22 ssh -4 -F /dev/null -o RequestTTY=no -o RemoteCommand=none [email protected] 'hostname; id -un' ``` Use `BatchMode=yes` only when password fallback would hang or prompt. ## Config ```bash sudo sshd -T 2>&1 | egrep -i '^(allowusers|denyusers|allowgroups|denygroups|listenaddress|maxstartups|logingracetime|usepam|passwordauthentication|pubkeyauthentication|authenticationmethods)' sudo egrep -n '^[[:space:]]*(AllowUsers|DenyUsers|AllowGroups|DenyGroups|Match|MaxStartups|LoginGraceTime|ListenAddress|AuthenticationMethods|UsePAM|PasswordAuthentication|PubkeyAuthentication)\b' /etc/ssh/sshd_config /etc/ssh/sshd_config.d/* 2>/dev/null || true ``` Suspicious: - `DenyUsers` matching target user - restrictive `AllowUsers` / `AllowGroups` - `Match` block accidentally applying - tiny `MaxStartups` - tiny `LoginGraceTime` - `ListenAddress` missing target interface ## Logs ```bash sudo log show --last 30m --predicate 'process == "sshd" OR process == "launchd"' --style compact | tail -160 ``` Important Mac symptom: - client: `kex_exchange_identification: Connection closed by remote host` - server log: `Could not create new instance of inetd service: 67: Too many processes` - `launchctl print system/com.openssh.sshd`: high `copy count` - many `sshd-session: USER` processes parented by PID 1 This means launchd accepted TCP but refused to spawn more sshd inetd copies. ## Stale sshd-session Fix Inspect first: ```bash sudo launchctl print system/com.openssh.sshd 2>&1 | egrep 'active count|copy count|state =|last exit code|runs =' ps -axo pid,ppid,uid,user,state,lstart,etime,comm,args | awk '/sshd-session:/ && !/awk/ {print}' sudo lsof -nP -c sshd-session -iTCP 2>/dev/null | head -120 ``` If stale sessions are clearly stranded and blocking new SSH, terminate by selected command-line match: ```bash ps -axo pid=,args= | awk '/sshd-session: / && !/awk/ {print $1}' | xargs sudo kill -TERM sleep 2 ps -axo pid=,args= | awk '/sshd-session: / && !/awk/ {print}' ``` If `TERM` leaves blockers, re-check ownership and active shells before using `KILL`. ## Firewall Only after loopback works but remote fails: ```bash sudo /usr/libexec/ApplicationFirewall/socketfilterfw --getglobalstate sudo /usr/libexec/ApplicationFirewall/socketfilterfw --listapps | grep -i ssh -A2 -B2 || true sudo pfctl -sr 2>/dev/null | head -80 sudo pfctl -si 2>/dev/null | head -80 ``` Also check listen address and target interface: ```bash ifconfig | awk '/^[a-z0-9]+:/{iface=$1; sub(":","",iface)} iface ~ /^en[0-9]+$/ && /inet / {print iface, $2}' sudo lsof -nP -iTCP:22 -sTCP:LISTEN ``` ## OP Profile Block If asked to ensure `~/.profile` has a Codex-managed `OP_SERVICE_ACCOUNT_TOKEN` copied from another host: - verify exact variable/markers without printing value - copy only the matching line/block - redirect through a `chmod 600` temp file - never echo the token Presence check: ```bash awk 'BEGIN{b=0;e=0;x=0} /BEGIN Codex-managed OP_SERVICE_ACCOUNT_TOKEN/ {b=1} /END Codex-managed OP_SERVICE_ACCOUNT_TOKEN/ {e=1} /^[[:space:]]*(export[[:space:]]+)?OP_SERVICE_ACCOUNT_TOKEN=/ {x=1} END{print "marker_begin", b; print "marker_end", e; print "exact_var", x}' ~/.profile ``` Append from remote host: ```bash tmpfile=$(mktemp /tmp/codex-op-token.XXXXXX) chmod 600 "$tmpfile" ssh -o RequestTTY=no -o RemoteCommand=none HOST 'awk '\''/^[[:space:]]*(export[[:space:]]+)?OP_SERVICE_ACCOUNT_TOKEN=/ {print; exit}'\'' ~/.profile' > "$tmpfile" if [ -s "$tmpfile" ]; then { printf '\n# BEGIN Codex-managed OP_SERVICE_ACCOUNT_TOKEN\n' sed -n '1p' "$tmpfile" printf '# END Codex-managed OP_SERVICE_ACCOUNT_TOKEN\n' } >> ~/.profile fi rm -f "$tmpfile" ``` ## Closeout Report: - root cause - exact commands changed - validation output, redacted as needed - whether remote should retry
© steipete · MIT · steipete/agent-scripts