Agent skill

Ssh

by zhinkgit in zhinkgit/embeddedskills

SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。

MITAuto-check: warnings

Install Ssh

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add zhinkgit/embeddedskills --skill ssh -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zhinkgit/embeddedskills ssh --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zhinkgit/embeddedskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ssh .claude/skills/ssh && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ssh
GitHub stars
734
Token cost
~914 tokens
SKILL.md length
158 words
Files
9 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。

  • Works in 6 steps: python scripts/ssh_config.py show <别名> → ssh -G <别名> 是否能解析 HostName/User/Port → 密钥文件是否存在,权限是否合适 → …
  • SKILL.md covers 定位, 何时触发, 脚本入口 and 常用命令, plus 3 more sections
  • Runs Python scripts from its folder; calls python and ssh

What it does

Ssh is an agent skill from zhinkgit/embeddedskills. SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `README.md`, `scripts/ssh_config.py` and `scripts/ssh_exec.py`).

It works with Python. The repository describes itself as: An open-source collection of embedded development and debugging skills for Claude Code, Copilot, TRAE, and other AI coding assistants that support the Skill protocol. Once… The licence is MIT.

Example prompts

  • “/ssh”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. python scripts/ssh_config.py show <别名>
  2. ssh -G <别名> 是否能解析 HostName/User/Port
  3. 密钥文件是否存在,权限是否合适
  4. ProxyJump 别名是否也在 ~/.ssh/config
  5. 网络是否可达,端口是否开放
  6. 首次连接是否需要显式追加 --accept-new-host-key

What it can do on your machine

Read from SKILL.md and the folder at commit 536c1f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ssh loads about 914 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~914

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:3
    SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:13
    ~/.ssh/config
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:22
    - 写入 `~/.ssh/config` 前必须自动备份。
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:34
    - 配置 `~/.ssh/config`、新增/查找服务器别名
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:92
    写入前脚本会自动备份 `~/.ssh/config`:
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:95
    ost <IP或域名> --user <用户> --port 22 --key ~/.ssh/id_ed25519
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:164
    IdentityFile ~/.ssh/id_ed25519
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:173
    IdentityFile ~/.ssh/id_ed25519
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:178
    IdentityFile ~/.ssh/id_ed25519
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:195
    - 新增或修改 `~/.ssh/config` 前,脚本必须创建备份。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from zhinkgit/embeddedskills at commit 536c1f9, republished under its MIT licence (© zhinkgit). 158 words, ~914 tokens.

Download SKILL.mdSave it as .claude/skills/ssh/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
ssh
description
SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。

SSH Skill

定位

这是一个轻量 SSH 操作网关。它不维护独立服务器数据库,默认只读取和写入标准 OpenSSH 配置:

text
~/.ssh/config

核心原则:

  • 使用 Host 别名标识服务器,不直接记忆 IP/密码。
  • 优先密钥认证和 OpenSSH 原生命令。
  • 通过本 skill 的 scripts/ 脚本执行 SSH、SCP、配置检查和隧道操作。
  • 环境识别优先使用固定只读探测,不用任意命令拼接临时采集脚本。
  • 写入 ~/.ssh/config 前必须自动备份。
  • 不鼓励密码落盘;如必须使用密码,优先让 OpenSSH 交互提示或由用户自行配置安全凭据。

何时触发

当用户提到以下任务时使用本 skill:

  • SSH、远程服务器、服务器 IP/主机名、user@host
  • 登录、执行远程命令、检查服务器状态
  • 上传、下载、部署、迁移文件
  • 跳板机、ProxyJump、内网访问
  • 隧道、端口转发、数据库连接
  • 配置 ~/.ssh/config、新增/查找服务器别名

不要用于本机 localhost、当前目录、本地文件操作或普通网络概念解释。

脚本入口

优先从当前 skill 目录调用脚本。脚本目录为:

text
scripts/

命令示例均以当前 skill 目录为基准。

常用命令

ssh_exec.py、ssh_transfer.py、ssh_tunnel.py 均支持:

bash
--accept-new-host-key
--known-hosts-file <临时known_hosts路径>

首次连接已确认可信的新开发板时,可显式追加 --accept-new-host-key。测试时如不想写入全局 known_hosts,可追加 --known-hosts-file <临时known_hosts路径>。

列出服务器
bash
python scripts/ssh_config.py list
查找服务器
bash
python scripts/ssh_config.py find <关键词>
python scripts/ssh_config.py find <环境关键词> <能力关键词>

多个关键词使用 AND 匹配。先用环境组缩小范围,再用设备别名或标签确定目标。 search 是 find 的等价命令。

确定唯一服务器
bash
python scripts/ssh_config.py resolve <关键词...>

仅在结果唯一时继续。退出码 2 表示存在多个候选;必须向用户确认,不能自动 选择第一项。精确的 OpenSSH Host 别名优先。

验证别名解析
bash
python scripts/ssh_config.py show <别名>
新增服务器

写入前脚本会自动备份 ~/.ssh/config:

bash
python scripts/ssh_config.py add <别名> --host <IP或域名> --user <用户> --port 22 --key ~/.ssh/id_ed25519

可选:

bash
--description "说明"
--aliases "常用名称1,常用名称2"
--groups "环境1,环境2"
--tags tag1,tag2
--location "位置"
--proxy-jump <跳板机别名>
执行远程命令
bash
python scripts/ssh_exec.py <别名> "命令" --timeout 30

脚本输出 JSON,包含 success、exit_code、stdout、stderr。

探测远端环境
bash
python scripts/ssh_probe.py <别名>

探测脚本只执行内置只读命令,并输出结构化 JSON。它默认启用非交互认证、 禁止端口和 Agent 转发,并要求主机指纹已经可信。需要先查看命令时使用 --dry-run;只有确认新设备可信时才使用 --accept-new-host-key。 探测入口显式禁用 SSH 配置中的 ProxyCommand,不要用它连接必须依赖代理 命令的目标。OpenSSH 仍会解析用户配置;配置中存在 Match exec 时可能执行 本地命令,因此只对可信的 SSH 配置使用探测入口。

上传文件
bash
python scripts/ssh_transfer.py upload <别名> "<本地路径>" "<远程路径>"
下载文件
bash
python scripts/ssh_transfer.py download <别名> "<远程路径>" "<本地路径>"
建立本地端口转发
bash
python scripts/ssh_tunnel.py <别名> --local-port <本地端口> --remote-host 127.0.0.1 --remote-port <远程端口>

隧道命令会前台运行。需要后台长期保持时,先向用户说明影响和停止方式。

配置格式

推荐配置:

ssh-config
# description: 开发板
# aliases: 测试板,主控板
# groups: 实验室测试环境
# tags: embedded,linux
# location: lab
Host 1380-P904
    HostName 192.168.137.76
    User root
    Port 22
    IdentityFile ~/.ssh/id_ed25519

跳板机:

ssh-config
Host bastion
    HostName bastion.example.com
    User root
    IdentityFile ~/.ssh/id_ed25519

Host internal-dev
    HostName 10.0.1.20
    User root
    IdentityFile ~/.ssh/id_ed25519
    ProxyJump bastion

允许保留注释元数据:

  • description
  • aliases
  • groups
  • tags
  • location

不要在配置中写入真实密码、Token、私钥内容或其他敏感信息。

操作规则

  • 查询类任务可以直接执行。
  • 新增或修改 ~/.ssh/config 前,脚本必须创建备份。
  • 删除配置、覆盖远程文件、部署、批量执行、端口转发等有风险操作,先向用户确认。
  • 不直接运行裸 ssh/scp,优先使用本 skill 的脚本;只有在脚本不可用或用户明确请求时,才说明原因并使用回退命令。
  • 不修改 Git、系统服务、防火墙、远程生产环境配置,除非用户明确要求。
  • 执行远程命令时优先只读检查;涉及重启、删除、覆盖、安装、升级时先确认。
  • 输出给用户时说明目标别名、实际 HostName、执行命令、关键结果和失败原因。

故障排查

优先检查:

  1. python scripts/ssh_config.py show <别名>
  2. ssh -G <别名> 是否能解析 HostName/User/Port
  3. 密钥文件是否存在,权限是否合适
  4. ProxyJump 别名是否也在 ~/.ssh/config
  5. 网络是否可达,端口是否开放
  6. 首次连接是否需要显式追加 --accept-new-host-key

如果脚本失败,保留真实 stderr,不要吞掉错误。

© zhinkgit, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts) in ssh of zhinkgit/embeddedskills.

  • SKILL.md
  • README.md
  • scripts/ssh_config.py
  • scripts/ssh_exec.py
  • scripts/ssh_probe.py
  • scripts/ssh_transfer.py
  • scripts/ssh_tunnel.py
  • tests/test_ssh_config.py
  • tests/test_ssh_probe.py

Open the folder on GitHubat commit 536c1f9

Compare with similar skills

Ssh next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ssh compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ssh this skillzhinkgit/embeddedskills734—~914Automated safety check: WarnMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k48 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 48 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    58k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed

More from zhinkgit/embeddedskills

All 12 skills in this repo
  • Can

    zhinkgit/embeddedskills

    嵌入式 CAN / CAN-FD 调试工具,用于扫描接口、监控报文、发送测试帧、记录日志、数据库文件解码和总线统计. An agent skill from zhinkgit/embeddedskills.

    734 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Eide

    zhinkgit/embeddedskills

    EIDE (Embedded IDE) 工程构建工具,用于扫描 .eide/eide.yml 工程、枚举构建 配置 (ConfigName)、执行 build/rebuild/clean 并解析构建日志,返回可供 jlink/openocd 复用的产物路径。当用户提到 EIDE、Embedded IDE、eide.yml、 unifybuilder、VS Code EIDE…

    734 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Jlink

    zhinkgit/embeddedskills

    J-Link 下载与在线调试工具,用于探测设备、烧录固件、读写内存、查看寄存器、复位目标、读取 RTT/SWO 日志, 以及在线调试(暂停/恢复/单步/断点运行/调用栈/变量查看)。

    734 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Keil

    zhinkgit/embeddedskills

    Keil MDK 工程构建工具,用于扫描 .uvprojx/.uvproj/.uvmpw 工程、枚举 Target、执行 build/rebuild/clean 并解析构建日志,返回可供 jlink/openocd 复用的产物路径。

    734 GitHub stars~883 tokensUpdated 1 mo ago
    Auto-check passed
  • Net

    zhinkgit/embeddedskills

    嵌入式网络调试工具,用于发现接口、抓包、分析 pcap/pcapng、做连通性测试、端口扫描和流量统计. An agent skill from zhinkgit/embeddedskills.

    734 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Openocd

    zhinkgit/embeddedskills

    OpenOCD 下载与调试工具,用于探针探测、固件烧录、Flash 擦除、GDB Server 启动、目标复位控制、 Telnet 在线调试(halt/resume/step/寄存器/内存/断点)、GDB 源码级调试,以及 Semihosting/ITM 输出捕获和底层查询。

    734 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Ssh

What does Ssh do?

SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务;以 ~/.ssh/config 的 Host 别名为唯一服务器清单,优先密钥认证,通过本 skill 的 Python 脚本封装 OpenSSH 操作。. Ssh is an agent skill from zhinkgit/embeddedskills.

How do I install Ssh in Claude Code?

Run `npx skills add zhinkgit/embeddedskills --skill ssh -a claude-code`. Or copy the skill folder (ssh in zhinkgit/embeddedskills) into .claude/skills/ssh in your project. Claude Code loads it when a task matches its description.

How do I install Ssh in Codex?

Run `npx skills add zhinkgit/embeddedskills --skill ssh -a codex`. Or copy the skill folder (ssh in zhinkgit/embeddedskills) into .agents/skills/ssh in your project. Codex loads it when a task matches its description.

Can I use Ssh in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zhinkgit/embeddedskills --skill ssh -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ssh, .gemini/skills/ssh, .github/skills/ssh and .opencode/skills/ssh in your project.

What does Ssh need to run?

Going by SKILL.md and its folder, Ssh needs Python for the scripts in its folder and the command-line tools its instructions call (python and ssh). Our summary lists: Python 3.

Does Ssh access the network?

SKILL.md contains no URLs. Its commands use ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ssh safe to install?

Our automated static check of SKILL.md flagged 10 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ssh use?

Ssh is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ssh use?

About 914 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ssh?

Skills that share tags, products or a category with Ssh: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ssh?

zhinkgit (a GitHub user) maintains it in zhinkgit/embeddedskills, which has 734 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 3, 2026.

Source: zhinkgit/embeddedskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.