ssh-troubleshooter

Diagnose SSH connection and session issues in KKTerm.

434|54|Updated May 1, 2026
One-click install
npx skills add https://github.com/ryantsai/KKTerm --skill ssh-troubleshooter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh-troubleshooter
Source: https://github.com/ryantsai/KKTerm/tree/main/assistant-skills/ssh-troubleshooter
Command: npx skills add https://github.com/ryantsai/KKTerm --skill ssh-troubleshooter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and resolve SSH Connection failures, tmux resume problems, host key warnings, authentication errors, ProxyJump issues, and SFTP-over-SSH startup problems in KKTerm.

Core Features & Use Cases

  • Diagnose Connection, Session, and SFTP startup issues across KKTerm's SSH transport.
  • Provide security-conscious host key handling and structured diagnostic steps.
  • Offer guided commands and safe, verifiable remediation suggestions for common SSH failures.

Quick Start

Identify the issue context and verify basic connectivity with the minimal required facts (host, port, and authentication method) to begin targeted troubleshooting.

Frequently Asked Questions about ssh-troubleshooter

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

FAQPage Schema
How do I troubleshoot SSH connection failures in KKterm?

To troubleshoot SSH connection failures in KKterm, verify basic connectivity, host reachability, DNS resolution, and authentication methods using structured diagnostic steps and safe remediation commands.

Why does SSH host key verification warning appear and how can I resolve it safely?

SSH host key warnings appear when the remote host key conflicts with the known hosts file. Resolve this safely by following security-conscious host key handling steps to verify and update the entry.

What is the best way to fix ProxyJump configuration issues during an SSH session?

The best way to fix ProxyJump configuration issues is to analyze connection settings and boundary considerations, applying structured checks to ensure the jump host routing is correctly specified.

How do I resume a tmux session when the SSH transport drops unexpectedly?

To resume a tmux session after an SSH transport drop, diagnose the underlying connection problem by checking authentication methods and host reachability, then reattach using safe, verifiable commands.

Does this SSH diagnostic process support SFTP startup problems?

Yes, the SSH diagnostic process supports SFTP startup problems by analyzing the underlying SSH transport settings and authentication methods to identify and resolve connection blocking issues.

What should I do if SSH authentication fails despite using the correct credentials?

If SSH authentication fails despite correct credentials, diagnose the issue by analyzing the configured authentication method, checking host reachability, and verifying safe credential handling procedures.