add-nixos-machine

What problem does it solve?

This skill removes guesswork and manual steps when adding new NixOS machine configurations to a dendritic flake repository by providing templates, a clear checklist, and small helper scripts to manage host IDs, IP allocation, and stateVersion discovery.

Core Features & Use Cases

• Step-by-step workflow: A checklist that walks through pre-checks, naming, hostId generation, inventory updates, IP allocation, module creation, validation loops, and committing.
• Templates and examples: Complete module templates for qemu-guest, Proxmox VMs, LXC containers, and bare-metal workstations to copy and adapt.
• Helper scripts: Utility scripts to generate an 8-character hostId, find an available IP in a network inventory file, and query the default stateVersion from a nixosConfiguration; intended for iterative validation with nix eval and formatting/linting tools.

Quick Start

Run the hostId generator to create an 8-character ID, add it to inventory/host-id.nix, allocate or skip an IP in inventory/networks/home.nix as appropriate, create modules/machines/<machine-name>.nix from the provided templates, validate with ncf eval nixos until clean, run get-state-version.sh to capture the system.stateVersion, then format and lint before committing.