opensite-ai/opensite-skills / linux-install-planner
linux-install-planner
FlaggedGenerate a safe, step-by-step runbook for installing Linux on a physical machine (replacing Windows, dual-booting, or a clean install) for a human sitting at the computer. Use when someone needs instructions to wipe Windows and install Linux, create bootable USB media, enter UEFI/BIOS, disable Secure Boot or Fast Startup, handle BitLocker or Intel RST, partition and encrypt a disk with LUKS, walk through a distro installer, or finish first-boot setup (drivers, firmware, power management). It emits instructions for a person to follow; it does not perform the install itself.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.6 KB |
| agents/openai.yaml | config | 454 B |
| examples/dell-xps-full-wipe-ubuntu.md | markdown | 5.6 KB |
| references/activation.md | markdown | 2.7 KB |
| references/bootable-media.md | markdown | 5.2 KB |
| references/first-boot-checklist.md | markdown | 4.1 KB |
| references/laptop-fixes.md | markdown | 4.2 KB |
| references/partitioning-encryption.md | markdown | 5.4 KB |
| references/uefi-secureboot.md | markdown | 5.0 KB |
| templates/install-runbook.md | markdown | 4.2 KB |
templates/install-runbook.md
View on GitHub# Linux Install Runbook — {{machine_make_model}}
> Personalized runbook generated by `linux-install-planner`. Fill every
> `{{placeholder}}`. `/dev/sdX` and `/dev/nvme0n1pN` are placeholders — replace
> with the device you verify at the machine. Complete and confirm each phase
> before starting the next. Verify all versions against a current web search.
**Plan summary**
- Target machine: `{{machine_make_model}}` ({{laptop_or_desktop}})
- CPU / GPU(s): `{{cpu}}` / `{{gpu_vendors_models}}`
- Wi-Fi chipset: `{{wifi_chipset}}` ({{wifi_risk_note}})
- Distro: `{{distro_and_version}}` (from linux-distro-selector)
- Strategy: `{{full_wipe_or_dual_boot}}` | Encryption: `{{luks_yes_no}}`
- Filesystem: `{{ext4_or_btrfs_or_zfs}}` | Swap: `{{zram_or_swap}}`
---
## ⚠️ DANGER CHECKLIST — do these before anything else
- [ ] Personal data backed up to external drive AND cloud; **opened the copy and
confirmed the files are there**. Windows recovery media created (if Windows
may be wanted back).
- [ ] BitLocker turned off / decrypted (dual-boot) and **recovery key saved**.
- [ ] Storage mode known: `{{rst_vmd_or_ahci}}`. If switching RST→AHCI while
keeping Windows, use the `bcdedit safeboot` dance.
- [ ] Fast Startup disabled (`powercfg /H off`) and machine **fully Shut Down**
(not Restart).
- [ ] Target disk identified with `lsblk`: `{{target_disk}}` — confirmed by
size/model before any flash or wipe.
---
## Phase 0 — End state
- [ ] Confirmed: {{full_wipe_or_dual_boot}}, encryption = {{luks_yes_no}}, distro =
{{distro_and_version}}.
## Phase 1 — Pre-flight
- [ ] Backup verified (above). - [ ] Windows recovery media made.
- [ ] Product key recorded: `(Get-CimInstance -ClassName SoftwareLicensingService).OA3xOriginalProductKey`
- [ ] Hardware recon captured (GPUs, Wi-Fi, storage soldered vs M.2, RST/AHCI,
fingerprint/IR webcam).
- [ ] BIOS/UEFI updated from the vendor Windows tool.
## Phase 2 — Bootable media
- [ ] ISO checksum verified. - [ ] ISO GPG signature = "Good signature".
- [ ] Writer: `{{ventoy_etcher_rufus_dd}}`. USB device confirmed: `{{usb_device}}`.
- [ ] ISO written / copied to the USB.
## Phase 3 — UEFI/BIOS + Windows prep
- [ ] `powercfg /H off` + full Shut Down. - [ ] BitLocker handled + key saved.
- [ ] Firmware key: `{{firmware_key}}`; one-time boot menu key: `{{boot_menu_key}}`.
- [ ] Secure Boot: `{{keep_or_disable}}` ({{shim_or_arch_reason}}).
- [ ] RST/VMD handled if needed. - [ ] TPM 2.0 left ON.
## Phase 4 — Partitioning, filesystem, LUKS
- [ ] Layout: ESP {{esp_size}} + root ({{fs}}) {{plus_home_or_not}}.
- [ ] Swap: {{zram_or_swap}} ({{swap_size_if_hibernate}}).
- [ ] Encryption: {{luks_choice}} (installer checkbox preferred).
- [ ] btrfs subvolumes + snapshot tool confirmed (if btrfs).
## Phase 5 — Installer walkthrough
- [ ] Booted USB via one-time menu; **tried the live session** (Wi-Fi, trackpad,
display all OK).
- [ ] Network connected. - [ ] Language/keyboard/timezone set.
- [ ] Third-party software checked (Ubuntu) / RPM Fusion planned (Fedora).
- [ ] Install type: `{{erase_alongside_manual}}` + Encrypt as chosen.
- [ ] Real hostname set: `{{hostname}}`. - [ ] Installed; USB removed; rebooted.
## Phase 6 — First boot
- [ ] Full update run. - [ ] Drivers installed (+ MOK enrolled if NVIDIA/Secure Boot).
- [ ] `fwupdmgr` firmware updates applied. - [ ] Flatpak/Flathub (+ RPM Fusion) added.
- [ ] Exactly ONE power manager active. - [ ] Hostname/timezone/locale confirmed.
- [ ] Fingerprint enrolled if supported.
## Phase 7 — Laptop fixes (only what applies)
- [ ] NVIDIA Optimus / PRIME configured: `{{prime_notes}}`.
- [ ] Wi-Fi firmware installed if needed: `{{wifi_fix}}`.
- [ ] Battery / power tuned. - [ ] Suspend mode verified (`cat /sys/power/mem_sleep`).
- [ ] HiDPI / scaling set (Wayland preferred).
## Phase 8 — Reversibility
- [ ] Windows recovery media + install USB kept as rescue.
- [ ] LUKS header backed up off-machine (`cryptsetup luksHeaderBackup`).
- [ ] Noted: don't casually toggle RST↔AHCI or Secure Boot/TPM after install.
---
**Next:** with first boot working, switch to the `linux-dev-workstation` skill to
configure the dev environment, then `linux-ai-dev-stack` for the AI toolchain.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |