Agent-Skills.md

Agent Skills: SSH Remote Connection

SSH connection to remote servers. Use when you need to execute commands on a remote server, check logs, restart services, or manage Docker containers.

UncategorizedID: artwist-polyakov/polyakov-claude-skills/ssh-remote-connection

Repository

artwist-polyakov/polyakov-claude-skills
artwist-polyakovLicense: MIT
5713

Install this agent skill to your local

pnpm dlx add-skill https://github.com/artwist-polyakov/polyakov-claude-skills/tree/HEAD/plugins/ssh-remote-connection/skills/ssh-remote-connection

Skill Files

Browse the full folder contents for ssh-remote-connection.

Download Skill

Loading file tree…

plugins/ssh-remote-connection/skills/ssh-remote-connection/SKILL.md

Skill Metadata

Name
ssh-remote-connection
Description
SSH connection to remote servers. Use when you need to execute commands on a remote server, check logs, restart services, or manage Docker containers.

SSH Remote Connection

Universal skill for connecting to remote servers via SSH.

Usage

# Interactive shell
scripts/connect.sh

# Run command directly
scripts/connect.sh "docker compose logs backend --tail 50"

Setup

For Claude Code (local)

  1. Copy config template:

    cp config/.env.example config/.env

  2. Fill in config/.env with actual values

    Key-based authentication:

    SSH_HOST=your-server.example.com
SSH_USER=ubuntu
SSH_AUTH_METHOD=key
SSH_KEY_PATH=/absolute/path/to/private/key
SSH_KEY_PASSWORD=
SERVER_PROJECT_PATH=/path/to/project

    Password-based authentication:

    SSH_HOST=your-server.example.com
SSH_USER=ubuntu
SSH_AUTH_METHOD=password
SSH_PASSWORD='your account password'
SERVER_PROJECT_PATH=/path/to/project

  3. Make script executable:

    chmod +x scripts/connect.sh

For Cloud Runtime

Set environment variables in your cloud configuration:

  • SSH_HOST — server hostname or IP
  • SSH_USER — SSH username
  • SSH_PORT — SSH port (optional)
  • SSH_AUTH_METHOD — auto, key, or password (optional, defaults to auto)
  • SSH_KEY_PATH — path to private key for key authentication
  • SSH_KEY_PASSWORD — key passphrase (optional)
  • SSH_PASSWORD — SSH account password for password authentication
  • SERVER_PROJECT_PATH — project directory on server

For password authentication, the local runtime must have either sshpass or expect. If the host key is not trusted yet, connect once manually or add the host to known_hosts before running non-interactive commands.

Important Notes

  • Git operations: Do NOT run git pull on the server. User will handle git sync manually.
  • Code location: Code is in a private repo, changes must be pushed first then pulled by user.
  • Docker: Use docker compose (not docker-compose) on the server.

Example Commands

# View logs
scripts/connect.sh "docker compose logs backend --tail 100"

# Restart service
scripts/connect.sh "docker compose restart backend"

# Rebuild and restart
scripts/connect.sh "docker compose build backend && docker compose up -d backend"

# Check status
scripts/connect.sh "docker compose ps"