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 |
examples/dell-xps-full-wipe-ubuntu.md
View on GitHub# Worked Example — Dell XPS, Full Wipe → Ubuntu 26.04 LTS, LUKS
A complete runbook as `linux-install-planner` would hand it over. Demonstrates
planner voice ("you will…"), the danger checklist first, and phase-by-phase
handoff. Versions are "as of 2026-07 — verify."
**Scenario.** New Dell XPS 13 (single soldered NVMe, Intel iGPU only, Intel Wi-Fi,
16 GB RAM). User wants a clean AI-dev machine, no Windows, encrypted. Distro
chosen via `linux-distro-selector`: **Ubuntu 26.04 LTS** (best laptop firmware/
driver support, huge community). Strategy: **full wipe + LUKS + btrfs**.
---
## ⚠️ Before you touch anything — DANGER CHECKLIST
1. **Back up.** Copy your files to an external drive and to cloud. Open the copy
and confirm the files really opened. A full wipe erases everything including
Dell's hidden recovery partition. If you might want Windows back, make Windows
recovery media now (search "recovery drive", 16–32 GB USB).
2. **BitLocker.** Full wipe, so encryption won't block the erase — but save your
BitLocker recovery key from your Microsoft account in case you abort.
3. **Storage mode.** Dell XPS often ships in **RAID/RST** mode. You'll check this
in Phase 3; modern Ubuntu usually sees the NVMe anyway. Full wipe means you can
switch straight to AHCI if needed — no `bcdedit` dance.
4. **Fast Startup.** In an admin prompt run `powercfg /H off`, then pick **Shut
down** (not Restart).
5. **Right disk.** When you flash the USB and when you erase, you'll confirm the
device with `lsblk` first. Your internal NVMe is the ~512 GB / 1 TB disk; the
USB is the small removable one. Never point a writer at the internal disk.
---
## Phase 0 — End state
Full wipe (Linux only), LUKS2 encryption ON, Ubuntu 26.04 LTS, btrfs root.
## Phase 1 — Pre-flight
- You backed up and verified (above).
- Record the OEM key from PowerShell (admin):
`(Get-CimInstance -ClassName SoftwareLicensingService).OA3xOriginalProductKey`
— blank output is normal (digital license in firmware).
- Recon: single soldered NVMe, Intel iGPU (no NVIDIA — no MOK dance needed),
Intel AX Wi-Fi (works on the live USB). Good, low-risk machine.
- Update the BIOS from Dell's Windows tool now.
## Phase 2 — Bootable media
- Download the Ubuntu 26.04 desktop ISO and `SHA256SUMS` + `SHA256SUMS.gpg`.
- Verify:
```bash
gpg --keyid-format long --keyserver hkp://keyserver.ubuntu.com \
--recv-keys 0x843938DF228D22F7B3742BC0D94AA3F0EFE21092
gpg --verify SHA256SUMS.gpg SHA256SUMS # "Good signature"
sha256sum -c SHA256SUMS 2>&1 | grep OK
```
- Write with **Ventoy** (so you can also try Fedora/Pop!_OS later): install Ventoy
to the USB (confirm the USB device via `lsblk` first — `/dev/sdX` is a
placeholder), then copy the verified `.iso` onto Ventoy's partition.
## Phase 3 — UEFI/BIOS + Windows prep
- Already did `powercfg /H off` + Shut Down.
- Boot and tap **F2** for firmware; note **F12** for the one-time boot menu.
- **Secure Boot:** keep it **ON** — Ubuntu ships a signed shim, and there's no
NVIDIA driver here needing MOK.
- **Storage:** if the Ubuntu installer later shows no disk, come back and set SATA
Operation to **AHCI** (full wipe, so switch freely).
- **TPM:** leave 2.0 enabled.
## Phase 4 — Partitioning, filesystem, LUKS
- You'll use the installer's "Erase disk and install Ubuntu" + the **Encrypt**
checkbox (LUKS2 + Argon2id) — no manual `cryptsetup` needed.
- Choose **btrfs** for snapshot rollback. 16 GB RAM, no hibernate → **zram**
(Ubuntu enables it) plus an optional 8 GB swapfile.
## Phase 5 — Installer walkthrough
1. Insert USB, reboot, **F12** → pick the USB (Ventoy → the Ubuntu ISO).
2. Choose **Try Ubuntu** first; confirm Wi-Fi, trackpad, and display all work.
3. Launch Install. Connect to Wi-Fi. Set language/keyboard/timezone.
4. **Check** "Install third-party software for graphics and Wi-Fi hardware and
additional media formats."
5. Install type: **Erase disk and install Ubuntu** → Advanced → choose **btrfs** →
tick **Encrypt** and set a strong passphrase (write it down offline).
6. Create your user; set a **real hostname** (e.g. `xps-dev`, not `user-pc`).
7. Install, remove the USB when prompted, reboot; enter the LUKS passphrase.
## Phase 6 — First boot
```bash
sudo apt update && sudo apt full-upgrade
fwupdmgr refresh --force && fwupdmgr get-updates && fwupdmgr update
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
hostnamectl; timedatectl
```
- No NVIDIA, so no driver step. Power management: keep the default
**power-profiles-daemon** (do not add TLP unless you need it).
- Enroll fingerprint if the XPS reader is supported: `fprintd-enroll`.
## Phase 7 — Laptop fixes
- Intel iGPU + Intel Wi-Fi → nothing special.
- Suspend: `cat /sys/power/mem_sleep`. If it shows `[s2idle]` and battery drains
in a bag, first apply BIOS updates via `fwupdmgr`; that fixes most XPS cases.
- HiDPI: GNOME on Wayland handles the XPS panel; set fractional scaling in
`Settings → Displays` if needed.
## Phase 8 — Reversibility
- Keep the Ventoy USB as your rescue environment.
- Back up the LUKS header off-machine:
```bash
sudo cryptsetup luksHeaderBackup /dev/nvme0n1p3 \
--header-backup-file luks-header-backup.img # replace pN with your LUKS partition
```
- Don't casually flip Secure Boot or storage mode now — it can trigger a LUKS or
boot problem.
---
**Result.** Encrypted Ubuntu 26.04 LTS on the XPS, snapshots via btrfs, firmware
current. **Next:** run `linux-dev-workstation` to set up the dev environment, then
`linux-ai-dev-stack` for local + cloud AI tooling.
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 |