ssh-remote-troubleshooting SKILL.md skillA
ssh-remote-troubleshooting from black-yt/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add black-yt/skills/ssh-remote-troubleshooting@git:20261003.b4dd22bPins git:20261003.b4dd22b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- black-yt/skills
- Path
ssh-remote-troubleshooting/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261003.b4dd22b, committed Oct 3, 2026
- Size
- 6,787 bytes
- Repository stars
- 16
- License
- none declared
排查 SSH 与 VS Code Remote SSH 连接故障，尤其是终端能登录但编辑器失败、Windows 临时目录拒绝访问、配置档未生效、远端服务安装失败或系统盘被缓存和隐藏文件占满；支持保留运行任务的安装迁移与验证。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# SSH 与 VS Code Remote SSH 排障 把故障定位到本地启动、SSH 认证、远端安装或编辑器连接中的具体阶段，修复后从用户实际使用的客户端重新连接。 ## 核心规则 - **先分层**：普通 SSH 成功只证明该次 SSH 路径可用；Remote SSH 还依赖本地脚本、非交互 shell、转发、下载、解压和远端写入。 - **看首个错误**：`Failed to parse remote port` 常是后续症状。先检查它之前的拒绝访问、下载失败、磁盘满或启动错误。 - **同一客户端**：比较终端和编辑器实际使用的 SSH 可执行文件、配置文件、Host 别名、用户、密钥和跳板；不要因 PATH 探测出现几个 `ENOENT` 就重装 SSH。 - **最小修改**：先备份目标配置，再只改生效配置档中的相关键；JSONC 的注释和其他字段必须保留。不把旧版兼容开关写成所有版本的默认值。 - **保护任务**：迁移或删除服务目录前检查 PID、父子关系、工作目录、打开文件和内存映射；不能用 `pkill node`、全局杀进程或重启整台机器代替定位。 - **保护数据**：模型、环境、浏览器二进制、编译缓存与会话数据库不等于可随意删除的下载缓存。已有授权只覆盖明确的任务和路径。 - **停止条件**：无法证明文件归属、共享副本完整或进程不受影响时，保留该项并继续其他修复；不要循环重装、清空所有服务器目录或放宽全局权限。 - **日志安全**：只输出所需错误和阶段信息；SSH 配置、完整环境、启动命令和 VS Code 日志可能含内部地址、token 或密码，分享前必须脱敏。 ## 排查顺序 1. 记录客户端、Remote SSH 扩展和远端 OS 版本，确认实际主机别名与当前 VS Code Profile。 2. 从首个失败阶段选择下表 reference；已经正常的层不反复修改。 3. 若根因是存储，先区分文件系统、inode、缓存、打开但已删除的文件和被挂载遮住的文件。 4. 在已授权范围内做最小修复；临时改到数据盘时，记录实际安装路径与回迁条件。 5. 验证客户端的管理连接、扩展宿主连接和远端目录访问；若仍有断连，不能只凭监听端口宣告成功。 6. 比较受保护进程启动时间和文件清单，清理本次临时产物，报告最终目录、验证证据与尚未验证的项目。 ## 文件导航 | 序号 | 文件内容概览 | 关键词 | 触发时机 | 文件路径 | | --- | --- | --- | --- | --- | …
Read the whole file at its exact version.
How to install
mdr add black-yt/skills/ssh-remote-troubleshooting@sha256:1ac1523d1b867de0The line at the top of this page pins the label git:20261003.b4dd22b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_uepgkmsy4unoyion)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 3, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (6787 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
black-yt/skills · 16 stars · license none declared · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_uepgkmsy4unoyion GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/ssh-remote-troubleshooting GET https://markdownregistry.com/api/v1/blob/1ac1523d1b867de0f9732ecc803c67ae6d81c3684b2a24eb292bfe2a7ece3f83
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.