nixos-install

This skill acts as a procedural guide for performing clean installs or reimaging of NixOS systems directly from live media environments. It is specifically designed for users managing a technological ecosystem built on Nix flakes and sub-flakes. The skill emphasizes a progressive disclosure methodology, ensuring that users are only exposed to the necessary commands relevant to their specific hardware profile, such as Apple Silicon (Asahi Linux) or generic x86 platforms. It integrates seamlessly with a modular repository structure, allowing for the inclusion of hardware-specific modules, dev-shells, and personalized configuration profiles.

• Facilitates the transition to a declarative installation workflow, aligning with modern NixOS best practices for system reproducibility.

• Provides a branching logic system where primary installation steps can delegate to specialized sub-skills (e.g., apple-silicon) when dealing with unique kernel or UEFI requirements.

• Maintains a verified log of installation steps, ensuring that only proven procedures are surfaced to the user to reduce configuration drift and failure points.

• Supports the execution of remote Nix flakes using specific directory selectors, ensuring that system configurations remain portable and version-controlled.

• Requires the user to be operating within a live/rescue shell where standard Nix command-line tools are available.

• Users should be familiar with the repository structure, specifically the distinction between base NixOS modules and host-specific profiles.

• When encountering hardware-specific issues, always consult the sub-skill documentation first to prevent unnecessary troubleshooting.

• Operates by triggering specific run commands, such as using nix run with experimental flake features enabled, to pull and execute installation scripts directly from the source repository.

• Keeps a record of confirmed steps to prevent repeating manual configurations, favoring a 'record-as-you-go' philosophy for ongoing system maintenance and re-installation tasks.