upgrade-nixos
CommunityPlan-driven NixOS upgrades with safe rollback.
Authorrichardgill
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill provides a structured approach to upgrading NixOS releases, including assessing current state, pinning inputs, researching breaking changes, planning, executing, and validating, with rollback guidance.
Core Features & Use Cases
- Release-aware upgrades: Pin and upgrade flake inputs (nixpkgs, home-manager, nix-darwin, stylix) to a target release.
- Change impact research: Identify breaking changes that affect your config and workflows.
- Plan-driven execution: Create a detailed upgrade plan with steps, verification checks, and safe rollback.
- Use Case: Upgrading a NixOS server from 25.05 to 25.11 while validating services before and after.
Quick Start
Execute the upgrade flow locally by starting the process for a target release (e.g., "just upgrade-nixos"), then follow the prompts and verification steps.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: upgrade-nixos Download link: https://github.com/richardgill/nix/archive/main.zip#upgrade-nixos Please download this .zip file, extract it, and install it in the .claude/skills/ directory.