SSH Skill

Скилл SSH для Codex и Claude Code: команды на серверах, передача файлов и туннели с единым JSON-ответом и защитой от повторов.

  • 553 ★ репозитория
  • Последний коммит
Скилл

Широкий доступ

Почему такой уровень

  • Агент получает возможность выполнять команды на ваших серверах, передавать файлы и открывать туннели.
  • Массовые операции затрагивают сразу несколько машин, включая боевые.
Все причины и проверки

badseal/ssh-skill

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/ssh-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент получает возможность выполнять команды на ваших серверах, передавать файлы и открывать туннели.
  • Массовые операции затрагивают сразу несколько машин, включая боевые.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл оборачивает SSH в один Python-вход `scripts/ssh_skill.py`. Через него агент выполняет команды на удаленных серверах, загружает и скачивает файлы, передает данные между серверами, работает с конфигурацией, туннелями и фоновым процессом соединения. Вывод всегда одинаковый: один JSON-документ версии 1.0 в stdout, прогресс идет в stderr. Удаленные команды передаются отдельными аргументами и не проходят повторный разбор локальной оболочкой. Если запрос ушел, а ответ не получен, результат помечается `outcome_unknown` и `retryable=false`, чтобы агент не повторил побочный эффект. Массовые операции по умолчанию только показывают план, а запуск требует `--apply`, для боевых целей еще и `--confirm-production`.

Для кого. Администраторы и разработчики, которые поручают агенту работу на своих серверах и хотят защиту от повторного выполнения и случайного запуска на боевых машинах.

Подходит, если

  • Агент выкладывает архив на сервер и читает журнал приложения.
  • Файл копируется между двумя серверами без промежуточной загрузки на ноутбук.
  • Одна команда выполняется на группе серверов после просмотра списка целей.
  • Нужен туннель к базе данных на удаленной машине.

Не подходит, если

  • Нет прав подключаться к серверам или нельзя давать агенту доступ к ним.
  • Задача решается локально, без удаленных машин.
  • Нужна проверка на Python 3.8 или 3.9: в формальную матрицу они не входят.

Пример запроса к агенту

Покажи список настроенных серверов, затем выполни `uname -a` на example-host и верни результат в формате JSON.

Ограничения

Нужны Python, клиент OpenSSH и Paramiko; формально поддерживаются Python 3.10–3.13. Автотесты не подключаются к реальным серверам, реальные проверки автор запускает отдельно. Новая конфигурация отклоняет пароли в открытом виде, старые читаются только с маскировкой. Агент получает доступ к вашим ключам и серверам, поэтому ограничьте список хостов и не передавайте продакшен-доступ без необходимости. README не дает готовой команды установки: скилл кладут в каталог скиллов агента, например `.claude/skills/ssh-skill/`.

Как отключить. Удалите каталог скилла из `.claude/skills/` или `.codex/skills/`, остановите запущенные туннели и демон соединений и уберите лишние записи из `~/.ssh/known_hosts`, если добавляли.

Частые вопросы

Что значит outcome_unknown?

Команда могла выполниться на сервере, а ответ потерялся. Повторять нельзя: сохраните request ID и проверьте состояние отдельной командой только для чтения.

Как запустить команду на группе серверов?

Сначала `cluster` с описанием окружения покажет цели без подключения. Затем добавляют `--apply`, для боевых серверов еще `--confirm-production`.

Хранятся ли пароли?

Новая конфигурация отклоняет пароли в открытом виде, старые читаются, но всегда скрываются в выводе.

Что с ключами хостов?

По умолчанию действует режим `accept-new`: новые ключи принимаются, а конфликт с известным ключом отклоняется.

Как проверить установку?

Выполните `python3 scripts/ssh_skill.py doctor --json`: команда покажет версию, копии скилла и расхождения.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Docker Skills

docker-skills

Официальный

Официальные скиллы Docker для агентов: Dockerfile и сборка, Compose, Sandboxes, Docker Agent и скилл с подтверждением необратимых действий

СкиллМинимальный доступ616Звезды репозитория

Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката

СкиллМинимальный доступ473Звезды репозитория

MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас

MCP-серверШирокий доступ1 тыс.Звезды репозитория

Мост буфера обмена по SSH: картинки из локального буфера попадают в Claude Code, Codex CLI и Cursor на удаленном сервере

CLIРасширенный доступ182Звезды репозитория

31 скилл для DevOps в Claude Code и Codex: генераторы конфигов, валидаторы и отладчик Kubernetes для Terraform, Helm, CI и Docker

СкиллРасширенный доступ332Звезды репозитория

Скилл для Claude Code и Codex выводит локальный сервис в интернет через Cloudflare Tunnel: временной ссылкой или на своем домене.

СкиллРасширенный доступ292Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
SSH Skill (эта карточка)нет553
MCP SSH ManagerнетAPI-ключ534MCP-сервер управления SSH; здесь скилл с локальным Python-входом, единым JSON-ответом и подтверждениями для боевых целей
SSH MCP Server (classfang) — команды на сервере по SSHнетне нужна1 019MCP-сервер SSH для агента; здесь готовый скилл с защитой от повторного выполнения и режимом предпросмотра

Коротко о README

В README разобраны версия 4.0.0, совместимость, вызов на каждой системе, команды, подтверждение для кластеров, формат результата и границы безопасности.

Бейдж для README

Сообщить о проблеме

Foxx AISSH Skill
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.