remote-ssh-bridge_skill

Overview

This skill provides standardized SSH command templates for running remote operator tasks like bird reads, Puppeteer jobs, and inbox-style messaging. It bundles small, reviewable shell scripts to check remote access and send messages through a configured REMOTE target. The design keeps network activity limited to SSH transport and avoids embedding secrets.

How this skill works

The skill supplies two primary scripts: a health/check template and a message-send template. You set an environment variable REMOTE_TARGET with your SSH target (user@host) and invoke the scripts; they execute the specified remote commands over an SSH session. Placeholders in the scripts mark where to insert your actual bird, Puppeteer, or inbox commands before running.

When to use it

• You need repeatable, auditable SSH command patterns for remote operator workflows.
• Running automated checks or simple health probes on a remote operator machine.
• Dispatching short inbox-style messages or triggering remote Puppeteer runs via SSH.
• When you must limit network activity to a single SSH transport channel for security or compliance.

Best practices

• Keep credentials and tokens in environment variables; do not hard-code secrets in scripts.
• Review and replace placeholder commands in the scripts before executing against any production host.
• Test scripts against a non-production REMOTE_TARGET first to validate behavior and output.
• Use SSH key authentication and an SSH agent to avoid password prompts and reduce exposure.
• Log script runs and SSH output centrally so you can audit remote actions.

Example use cases

• Run a nightly health check on a remote operator node with the provided check template.
• Trigger a remote Puppeteer job to capture browser-based reports via SSH without opening additional ports.
• Send maintenance or status messages to an operator inbox on a remote host with the msg template.
• Archive output from bird reads by piping remote command output back to local processing or storage.