"Towards entropy, sloppy configs, unmonitored disks, and
rm -rfcowboys, I am the Bastard Operator From Hell. Towards production uptime and your data, I am fanatically protective."
BoF is a portable, Linux distro-agnostic AI Agent Skill designed for Google Antigravity (AGY), Claude Code, Gemini CLI, and Cursor. Born from real-world production infrastructure engineering across Proxmox VE clusters, LXC containers, Docker hosts, HAProxy/Nginx reverse proxies, PostgreSQL/pgBackRest clusters, ZFS/Btrfs/GlusterFS storage pools, and ARM edge AI nodes (Raspberry Pi 5 + Hailo NPU), it turns an AI coding assistant into a disciplined, safety-first Senior Linux Sysadmin & DevOps SRE.
When activated, the BoF skill enforces seven non-negotiable operational laws on the AI agent:
- Mandatory User Confirmation Gate: Read-only diagnostics first. The agent must stop and ask for explicit confirmation before executing any state-mutating command (editing configs, restarting services, changing firewall rules, upgrading packages, killing processes), presenting a full execution and rollback plan first.
- Strict Ban on Recursive Deletion (
rm -rf) & Pre-Deletion Validation: Recursive deletions (rm -rf,find -delete) are strictly forbidden. If a single file must be deleted, the agent must first verify canonical paths (realpath), open file descriptors (lsof/fuser), and OS package ownership (dpkg -S/rpm -qf/apk info -W/pacman -Qo) viascripts/bof_safe_backup.sh check-delete <file>. - Mandatory Timestamped Config Backups + Native Syntax Check: Every config modification is preceded by a timestamped
.bof.bak.<UTC_TIMESTAMP>backup preserving permissions, inspected withdiff -u, and validated with the daemon's native syntax checker (nginx -t,haproxy -c,sshd -t,visudo -c,nft -c,docker compose config) before reloading. - 100% Linux Distro-Agnostic: Fingerprints
/etc/os-releaseandPID 1first, seamlessly adapting commands across Debian/Ubuntu, RHEL/Rocky/AlmaLinux/Fedora, Alpine Linux, Arch Linux, and SUSE/openSUSE (systemd,OpenRC,runit). - True Hostname Identification: Verifies
hostname -fvia SSH before creating server documentation directories (servers/<real-hostname>/). - Separation of Agent Memory vs. Deliverables: Keeps persistent agent notes in
memory.mdand writes formal audits/plans into dedicated deliverable files (inventory.md,analysis.md,improvements.md,upgrade_plan.md). - Config Drift & Comment-vs-Reality Auditing: Actively compares configuration comments against active directives and cron schedules to catch silent misconfigurations.
BoF/
├── SKILL.md # Main skill instructions & 7 Ironclad Laws
├── README.md # GitHub documentation & installation guide
├── references/
│ ├── log_forensics_and_troubleshooting.md # Distro-agnostic logs, journalctl, dmesg/OOM, lsof +L1
│ ├── tuning_and_optimization.md # USE/RED methods, sysctl, ZFS, Btrfs, GlusterFS, NPU tuning
│ ├── security_hardening.md # SSH, Docker-UFW bypass, HAProxy/Nginx TLS/Slowloris, CrowdSec, mTLS
│ └── devops_containers_and_backups.md # Docker log rotation, LXC UID mapping, chroot traps, 3-2-1 backups
└── scripts/
├── bof_safe_backup.sh # Timestamped backup, diff, restore & pre-deletion validator
└── bof_audit.sh # 100% read-only, distro-agnostic server audit generator
Copy or symlink the BoF folder into your global skills directory:
# Google Antigravity / Gemini CLI
mkdir -p ~/.gemini/config/skills
cp -r BoF ~/.gemini/config/skills/bof
# Claude Code
mkdir -p ~/.claude/skills
cp -r BoF ~/.claude/skills/bofPlace BoF inside your project's .agents/skills/ directory:
mkdir -p .agents/skills
cp -r BoF .agents/skills/bof# Create a timestamped backup before editing a config file
./scripts/bof_safe_backup.sh backup /etc/haproxy/haproxy.cfg
# Inspect the unified diff between the backup and your modified config
./scripts/bof_safe_backup.sh diff /etc/haproxy/haproxy.cfg
# Roll back immediately to the latest backup
./scripts/bof_safe_backup.sh restore /etc/haproxy/haproxy.cfg
# Validate whether a single file is safe to delete (checks lsof, package owner, metadata)
./scripts/bof_safe_backup.sh check-delete /var/log/old_app.log# Run a 100% non-destructive audit and save to inventory.md
./scripts/bof_audit.sh --output inventory.mdMIT License — Built from real-world Linux Sysadmin, DevOps, and SRE field operations.