Files
magnus919_agent-skills/remote-systems-administration

Remote Systems Administration

Operate remote Linux, FreeBSD, NetBSD, OpenBSD, and macOS hosts safely, without pretending their service managers, packages, firewalls, and configuration systems are interchangeable.

Why Install This Skill

Remote administration is where a plausible command can turn into an outage. This skill gives an agent a disciplined path from host discovery through scoped change and verification. It starts with native SSH for a single bounded job, moves to Ansible for repeatable fleet work, and reserves Paramiko for Python programs that actually need protocol-level control.

It is deliberately platform-aware. The agent learns to find the active control plane before touching a service, package, firewall, or configuration file, and to preserve a rollback path before changing anything that could strand remote access.

What You Get

Resource What it provides
SKILL.md Operating contract, routing, boundaries, and verification checklist
references/portable-operations.md POSIX baseline, SSH, discovery, diagnostics, and bounded evidence
references/fleet-automation.md Ansible, Paramiko, inventory, canary, and rollout guidance
references/linux.md Linux init, packages, logs, and firewall routing
references/freebsd.md FreeBSD rc, packages, jails, and firewall routing
references/netbsd.md NetBSD rc.d, services, pkgsrc, and firewall routing
references/openbsd.md OpenBSD rcctl, updates, packages, and PF routing
references/macos.md launchd, updates, profiles, and macOS operational limits
references/safety-and-verification.md Mutation gates, rollback, and verification evidence
references/source-index.md Primary sources and freshness notes
templates/remote-change-plan.md A compact plan for a remote change before it starts

Quick Start

Start with a read-only preflight. Replace the example target with a host you are authorized to inspect.

ssh admin@example-host 'uname -srm; command -v systemctl service rcctl launchctl; id'

Then load the matching platform reference before choosing a service manager, package tool, or firewall control plane. For fleet work, put targets in an Ansible inventory, run a canary with --limit, and use --check --diff only with its limitations understood.

Triggers

Use this skill when you need to:

  • diagnose or administer a remote Linux, FreeBSD, OpenBSD, or macOS host;
  • manage services, packages, updates, configuration, logs, or firewalls;
  • use SSH, a bastion, file transfer, Ansible, or Paramiko;
  • make a controlled change across several Unix-like machines;
  • plan rollback and verification for a remote operational change.

Requirements

You need legitimate remote access and the authority to perform the requested operation. Native SSH is the baseline. Ansible is optional for fleet configuration, and Python plus Paramiko is optional for programmatic SSH workflows. The skill does not create credentials, bypass host-key validation, or authorize destructive operations.