Pi Admin

Raspberry Pi system administration. Monitor resources, manage services, perform updates and maintenance.

Security Scan

The skill's files and runtime instructions are consistent with a Raspberry Pi administration utility: it reads system state, manages services, performs updates/cleanup, and requires sudo for maintenance actions.

Purpose & Capability

The name and description match the included scripts: monitoring (overview, resources, storage, network, tailscale, hardware), maintenance (update, clean, optimize, reboot) and service management (services, restart-gateway). All required actions (system inspection, systemctl, apt, journalctl, docker, reboot, pnpm for a gateway) are proportional to Raspberry Pi administration. Minor oddities: several scripts reference a specific user path (/home/srose/clawdis) and the restart-gateway script contains inconsistent port numbers (scripts start port 18789 but some messages refer to 18790). Those are configuration issues, not indicators of hidden functionality.

Instruction Scope

SKILL.md and the scripts are explicit about what to run and what they read: many /proc, /sys, /etc files, journalctl, /var/log/syslog, ip/ss outputs, docker lists, and tailscale commands. Maintenance commands require sudo and prompt for confirmation; dry-run flags exist. There is no instruction to send data to external endpoints or to harvest credentials, but the restart-gateway script does start a background pnpm process (silencing output) and prints local/Tailscale URLs — so running the skill will reveal local IPs and service ports. Review and adjust hard-coded paths before running.

Install Mechanism

No install spec is provided (instruction-only), and the package includes the actual shell scripts. Nothing is downloaded or executed from remote URLs by the skill itself. Risk is limited to running the included scripts on the host; there is no installer that pulls arbitrary code.

Credentials

The skill declares no environment variables or credentials and does not attempt to read secrets from environment variables. It operates on local system files and services only. The only external dependency implied is the presence of tools like pnpm, tailscale, docker, and systemctl — which are reasonable for the described tasks. No unrelated credentials are requested.

Persistence & Privilege

always:false and default autonomous invocation are set (normal). The scripts legitimately require elevated privileges for maintenance operations (apt, systemctl, sysctl, reboot). Be aware these actions can be disruptive: optimize disables services and writes /etc/sysctl.d/99-swappiness.conf, restart-gateway pkills processes and starts a pnpm process, and reboot performs a system reboot. These are expected for an admin tool but require user consent and care.

Assessment

This skill appears to do what it says: inspect and administer a Raspberry Pi. Before using it: (1) review the scripts yourself (they are included) and correct hard-coded paths (e.g., /home/srose/clawdis) and the port inconsistencies in restart-gateway; (2) run read-only commands or use the provided --dry-run flags to preview changes; (3) ensure pnpm/tailscale/docker expectations match your system; (4) be cautious granting sudo — maintenance actions (update, clean, optimize, reboot, restart-gateway) will modify services, write sysctl configs, or reboot the device; (5) if you want the agent to run autonomously, understand it could invoke these sudo-requiring scripts (the skill will still prompt for confirmation in many cases, but double-check behavior).

Raspberry Pi Administration

Complete system monitoring and introspection for the Raspberry Pi host. Access network details, system resources, storage, services, and more.

When to Use

• Checking Pi network configuration (IP, Tailscale)
• Monitoring system resources (CPU, memory, storage)
• Viewing running services and their status
• Checking temperature and hardware info
• Troubleshooting system issues
• Getting system overview for debugging

Usage

# Information Commands
cd /home/srose/clawd/skills/pi-admin
./skill.sh overview
./skill.sh network
./skill.sh tailscale
./skill.sh resources
./skill.sh storage
./skill.sh services
./skill.sh hardware

# Maintenance Commands
./skill.sh update       # Update system packages
./skill.sh clean        # Clean unused packages, logs, Docker
./skill.sh reboot       # Reboot with countdown
./skill.sh restart-gateway  # Restart the Clawdis Gateway

# Complete system info
./skill.sh all

Tools Available

Tool	Description
overview	Quick system summary
network	IP addresses, hostname, network interfaces
tailscale	Tailscale status, IP, peers
resources	CPU, memory, temperature
storage	Disk usage, mount points
services	Running services, Gateway status
hardware	CPU info, Raspberry Pi model, GPU
all	Complete detailed dump

Examples

# Quick system check
./skill.sh overview

# Debug network issues
./skill.sh network && ./skill.sh tailscale

# Check if Gateway is running
./skill.sh services | grep gateway

# Monitor disk space
./skill.sh storage

Information Collected

Network:

• Hostname
• Local IP addresses (eth0, wlan0)
• Network interface details
• DNS configuration

Tailscale:

• Status (running/stopped)
• Tailscale IP
• Connected peers
• Exit node status

Resources:

• CPU usage
• Memory usage (used/free/total)
• CPU temperature
• Uptime

Storage:

• Disk usage by mount point
• Inode usage
• Free space

Services:

• Gateway service status
• Docker containers
• Systemd services
• Port listeners

Hardware:

• CPU model and cores
• Raspberry Pi model
• GPU memory
• Total RAM

Maintenance Commands

update

Update system packages via apt:

• Updates package lists
• Shows upgradable packages
• Requires confirmation before upgrading
• Reports if reboot is needed
• Dry run: ./skill.sh update --dry-run shows what would be updated

clean

Clean up system to free disk space:

• Removes unused packages (autoremove)
• Clears package cache
• Cleans old journal logs (keeps 7 days)
• Optionally cleans Docker artifacts
• Shows space saved
• Dry run: ./skill.sh clean --dry-run shows what would be cleaned

reboot

Graceful system reboot:

• 10-second countdown
• Ctrl+C to cancel
• Uses systemctl reboot
• Dry run: ./skill.sh reboot --dry-run shows countdown without rebooting

restart-gateway

Restart the Clawdis Gateway service:

• Stops all running gateway processes
• Starts fresh gateway on port 18789
• Confirms port is listening
• Shows access URLs
• Dry run: ./skill.sh restart-gateway --dry-run shows what would happen

optimize

Apply safe system optimizations:

• Disable Bluetooth service (~50MB RAM saved)
• Disable ModemManager (~30MB RAM saved)
• Disable Avahi/Zeroconf (~20MB RAM saved)
• Set swappiness to 10 (better RAM utilization)
• Dry run: ./skill.sh optimize --dry-run shows what would change
• Undo: ./skill.sh optimize --undo reverts all changes

Total RAM savings: ~100MB Reversibility: Yes, use --undo flag to revert

Note: All maintenance commands require sudo and ask for confirmation before making changes. Use --dry-run flag to preview changes without applying them.