ssh-server-ops

Diagnose SSH connectivity failures with layered local, network, and authentication checks.

16|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Xiaoyun-0922/sshops --skill ssh-server-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh-server-ops
Source: https://github.com/Xiaoyun-0922/sshops/tree/main
Command: npx skills add https://github.com/Xiaoyun-0922/sshops --skill ssh-server-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires paramiko, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

SSH failures are rarely as simple as "SSH is broken"—they usually stem from missing local tools, network issues, misconfigured SSH config, or broken authentication chains. This Skill eliminates guesswork by providing a structured, evidence-based workflow to diagnose the exact failure layer and safely repair SSH access from Windows, macOS, or Linux to Linux, POSIX, gateway, bastion, or HPC targets.

Core Features & Use Cases

  • Layered Diagnosis: The doctor command produces a structured JSON report covering local tools, TCP reachability, non-interactive public-key auth, transfer capability, and Conda/Paramiko readiness.
  • Safe Config & Key Management: Repair or create ~/.ssh/config host blocks and bootstrap password-to-key authentication with passwords confined to local terminal variables.
  • Remote Execution & Transfer Fallback: Run standardized remote commands through OpenSSH or fall back to Paramiko SFTP for file transfers, with first-class support for Slurm/HPC login nodes and bastion hosts.

Quick Start

Use the ssh-server-ops skill to run a read-only diagnosis on your target host and report the likely root cause along with the recommended next safe action.

Frequently Asked Questions about ssh-server-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose SSH connection failures from Windows to a Linux or HPC target?

Diagnose SSH connection failures by running a structured doctor command that tests local tools, network reachability, non-interactive public-key auth, and Paramiko readiness, generating a JSON report to isolate the exact failure layer.

What is the safest way to bootstrap password-to-key SSH authentication?

Bootstrap password-to-key SSH authentication safely by keeping passwords confined to local terminal variables while generating and deploying keys to the target host, ensuring credentials are not exposed in configuration files or scripts.

Can I use Paramiko for SFTP file transfers when OpenSSH fails on a bastion host?

Yes, Paramiko provides an SFTP fallback for file transfers when standard OpenSSH fails, supporting remote operations targeting bastion hosts and Slurm/HPC login nodes from Windows, macOS, or Linux workstations.

How do I repair a misconfigured SSH config file blocking access to remote servers?

Repair a misconfigured SSH config by restructuring or creating ~/.ssh/config host blocks, verifying non-interactive public-key authentication chains, and testing transfer capabilities to restore safe access to remote targets.

Why does SSH public-key authentication fail non-interactively on Slurm HPC login nodes?

SSH public-key authentication fails non-interactively on Slurm HPC login nodes due to misconfigured SSH config, broken authentication chains, or missing local tools, requiring layered diagnostics to isolate and repair the specific failing layer.