onboard

name

onboard

description

First-run setup for linux-system-optimisation. Detects the machine's hardware (CPU, GPU, RAM, storage type, kernel, distro, DE, display server), asks the user where to store benchmark results (default ~/linux-system-optimisation/benchmarks/), installs missing benchmark tools, then runs the first tailored benchmark via the `benchmark` skill. Triggers on "set up linux-system-optimisation", "first run", or any optimise/benchmark request when no config exists.

Onboard

One-time setup. Establishes a benchmark-results store the user owns, profiles the hardware, and runs the first benchmark so subsequent optimise runs have something to read.

Config + storage

Plugin config (small pointers only) lives at:

${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/linux-system-optimisation/config.json

Benchmark results (user-owned data — they may want to inspect, version, share) live at a user-chosen path. Default suggestion: ~/linux-system-optimisation/benchmarks/. Store only the pointer in config.json:

{
  "benchmarks_dir": "/home/<user>/linux-system-optimisation/benchmarks",
  "system_profile": { "...": "see below" },
  "first_run_at": "<ISO-8601>"
}

If config.json already exists, this skill is a no-op — surface that and suggest benchmark instead.

Steps

1. Pick the benchmark folder. Confirm or override the default. Create it.
2. Profile the hardware. Capture into system_profile:
   • CPU: lscpu -J → model, vendor, cores/threads, base/max MHz, flags.
   • GPU: lspci -nn | grep -iE 'vga|3d|display'; for NVIDIA also nvidia-smi -q | head -40; for AMD also glxinfo | grep -i 'opengl renderer'.
   • RAM: free -h + dmidecode -t memory (sudo) for module-level info if available.
   • Storage: lsblk -d -o NAME,ROTA,TRAN,MODEL,SIZE — distinguish NVMe / SATA-SSD / HDD.
   • Kernel + distro: uname -r, lsb_release -ds or cat /etc/os-release.
   • DE + display server: $XDG_CURRENT_DESKTOP, $XDG_SESSION_TYPE.
3. Install missing tools. Check each of sysbench stress-ng fio glmark2 vkmark mbw cpupower lm-sensors. Install missing ones via sudo apt install -y <pkg>. power-profiles-daemon is usually preinstalled on Ubuntu — check with systemctl status power-profiles-daemon.
4. Write config.json with the profile and pointer.
5. Hand off to benchmark to run the first measurement. Don't re-prompt — the user just confirmed they want to set up.

Notes

• Don't write to ~/.claude/.
• Don't put benchmark results under $CLAUDE_USER_DATA — those are user-owned.
• Only ask one question (the folder path); everything else is detected.