SkillAgentSearch skills...

ssh-ops

Operate remote SSH servers through the bundled CLI and YAML server configurations. Use for remote commands, service restarts, log inspection, file transfer, text edits, deployments, background jobs, and aliases on bash/cmd/powershell servers, even when the user does not explicitly mention SSH.

Install / Use

npx skills add hashgraph-online/awesome-codex-plugins --skill ssh-ops

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

85/100

Category

Operations

Supported Platforms

Universal

Our assessment of ssh-ops

ssh-ops scores 85/100 on our quality scale, 537th of 763 Operations skills we index.

Its SKILL.md is 5.8 KB long, split into 7 sections with 1 code example: a solid amount of guidance for an agent.

With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
15/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so ssh-ops is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

ssh-ops compared with similar skills

All 4 of these similar skills score higher than ssh-ops; compare them before choosing.

SkillScoreStarsUpdatedFormat
ssh-ops (this skill)by hashgraph-online851.1k56d agoSKILL.md
Agent-Reachby Panniantong100113.3k12d agoCLAUDE.md
algorithmic-artby anthropics100177.9k58d agoSKILL.md
pptxby anthropics100177.9k58d agoSKILL.md
prospectingby coreyhaines3110060.1k8d agoSKILL.md

Frequently asked questions

How do I install ssh-ops?
Run npx skills add hashgraph-online/awesome-codex-plugins --skill ssh-ops. The install tabs above show the steps for each supported agent.
Which AI agents does ssh-ops work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is ssh-ops safe to use?
It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is ssh-ops still maintained?
The repository was last updated about 2 months ago, so ssh-ops is actively maintained.

name: ssh-ops description: > Operate remote SSH servers through the bundled CLI and YAML server configurations. Use for remote commands, service restarts, log inspection, file transfer, text edits, deployments, background jobs, and aliases on bash/cmd/powershell servers, even when the user does not explicitly mention SSH. Local-only builds and GitHub releases without a remote server operation are outside this skill's scope. Trigger keywords: deploy, release, ship, server health, SSH, run on server, upload script, download file, server alias, 部署, 上线, 发布, 重启, ζŸ₯ηœ‹ζ—₯εΏ—, ζœεŠ‘ε™¨ε₯εΊ·ζ£€ζŸ₯.

ssh-ops CLI skill

中文参考

Locate the tool and target

Use the directory containing this skill file as the tool root to locate cli.py. Use a Python interpreter with the project's dependencies installed. Do not assume the user's project contains cli.py, and do not change the user's project working directory just to run this tool. The python cli.py examples below are shorthand: invoke the confirmed interpreter and CLI by absolute path. Local file paths resolve against the current working directory.

Reuse an interpreter already confirmed for this installation; otherwise check the checkout's virtual environment or the configured interpreter before installing anything. For example, after replacing the paths with the actual installation:

/absolute/path/to/python /absolute/path/ssh-ops/cli.py my-server run "uptime"

Use list-servers to confirm server names. Do not guess names or substitute listing indexes for names. Before reusing an operation, use list-aliases to inspect its command, sudo setting, and timeout. Do not repeat discovery already completed for the same task. Read the installation guide only when dependencies or configuration are missing.

Choose the operation

  • Prefer a suitable existing alias after checking that its content, target, and privileges match the task.
  • Use run for ad hoc checks. For complex quoting, $, or multiline commands, use run - with a quoted heredoc to avoid local shell expansion.
  • Use text I/O for small configurations and log excerpts. Transfer binary files, large files, or text that must be preserved exactly; do not concatenate paged text as a lossless copy.
  • Use background jobs for operations likely to exceed one request's wait time. Save the returned job ID and query its status. Background jobs require a bash server.
  • For deployment, read the deployment chapter before generating and executing project scripts. Do not improvise a sequence of release commands.

Command quick reference

Server operations in the table are prefixed with python cli.py <server>. Full options and defaults are maintained only in the CLI reference.

| Purpose | Command | |---|---| | Discover servers | python cli.py list-servers | | Inspect and run aliases | list-aliases, alias <name> | | Execute commands | run '<command>'; use run - to read complex commands from stdin | | Upload and run scripts | upload <local>, run-script <name>, upload-all, list-scripts | | Transfer files | upload-file <local> <remote>, download-file <remote> <local> | | Download directories and scripts | download <remote> <local>, download-script <name> <local> | | Read and write text | read-file <remote>, write-file <remote> < input.txt | | Long-running work | job-start '<command>' β†’ job-status <id>; use job-kill <id> when termination is needed | | List jobs | job-list |

For creating, updating, copying, or deleting local server configurations, choose the specific command from the CLI reference. Do not modify local configuration files through remote operations.

Important rules

  • Put options after positional arguments. There is no --overwrite: transfers overwrite by default, and selected transfer commands accept --no-overwrite.
  • Use CLI -s for sudo; never embed passwords in commands. Aliases use YAML privilege and timeout settings, not CLI -s/-t overrides.
  • Read a remote configuration before modifying it and retain a recoverable copy. Validate with the application's own checks before restarting.
  • Act when the user has clearly authorized the operation and the target and scope are clear. Ask when the target, deletion scope, or required privileges are unclear; do not ask again for authorization already given.
  • Use CLI run, run-script, or alias for live output; MCP does not stream execution progress.
  • Text paging, sudo staging, command filtering, and path restrictions have limits documented in the runtime reference. Regex filtering is not a sandbox.

Deployment

Follow the deployment chapter: confirm the server, region, mode, directory, ports, and health endpoint, then generate project-specific local and server scripts. The deploy/scripts/ templates require customization; they are not ready-to-run universal release tools. Route all remote interaction through this CLI. The deployment chapter is the authority for package-source and health-check rules.

Verify and report

Successful startup is not task completion. Inspect operation exit codes and actual output. For background jobs, check the final state and job exit code; for releases and restarts, also check application health. A successful local CLI exit alone is insufficient.

A normal command timeout does not guarantee that its remote process stopped. After a timeout or disconnect, inspect remote jobs, processes, and service state before deciding whether to retry. Avoid duplicate deployments or migrations.

Report the target server, operations actually performed, and verification results. State what remains incomplete or unverified. If work is still running, include the job ID rather than claiming completion.

For the MCP interface, see SKILL.mcp.md.

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryOperations
Updated1mo ago
Forks294

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

No cautions
ssh-ops β€” Universal Skill: Install & Safety Check | SkillAgent