sshepherd
Zero-knowledge SSH ops CLI — server health checks, docker/systemd control, log tailing, Postgres introspection, and declarative deploys, without ever exposing credentials to the agent.
Profile →npx skills add sickn33/agentic-awesome-skills --skill sshepherd --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# sshepherd ## Overview `sshepherd` is a compiled Bun/TypeScript CLI that lets an agent operate a real remote server over SSH — health checks, docker/systemd service control, log tailing, config file edits, read-only Postgres introspection, and declarative deploys — without ever seeing a password, private key, hostname, username, or port. Every operation shells out to the system `ssh` binary through a single transport path and returns the same typed `Envelope<T>` (`ok`, `alias`, `data`, `error`), never a raw terminal dump. The agent passes only a *name* — an ssh alias, a Postgres target, or a deploy recipe — that resolves entirely outside the process. ## When to Use This Skill - Use when you need to check a remote server's health (disk, memory, CPU, ports, OOM history) without handing the agent SSH credentials. - Use when working with remote docker or systemd services — listing, inspecting, or restarting them — or tailing their logs. - Use when the user asks to read or edit a remote config file, run a declarative deploy from a named recipe, introspect a remote Postgres database read-only, or audit SSH/security posture on a box. ## How It Works ### Step 1: Declare targets once, outs
- Overview
- When to Use This Skill
- How It Works
- Step 1: Declare targets once, outside any prompt
- Step 2: Invoke a group + action by name
- Step 3: Discover the command surface
- Examples
- Example 1: Server health overview
- Example 2: Restart a docker service and tail its logs
- Example 3: Read-only Postgres introspection
- Best Practices
- Limitations
- Security & Safety Notes
- Common Pitfalls
What does the sshepherd skill do?
Zero-knowledge SSH ops CLI — server health checks, docker/systemd control, log tailing, Postgres introspection, and declarative deploys, without ever exposing credentials to the agent.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill sshepherd --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.