Upgrade NixOS releases by updating flake inputs and handling breaking changes.
npx skills add https://github.com/richardgill/nix --skill upgrade-nixos
Please help me install this Agent Skill. Skill: upgrade-nixos Source: https://github.com/richardgill/nix/tree/main/.claude/skills/upgrade-nixos Command: npx skills add https://github.com/richardgill/nix --skill upgrade-nixos
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.
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.
High-intent search queries and answers about installing and using this skill.
NixOS upgrades require updating version-pinned flake inputs and addressing breaking changes between releases. This Skill automates the process by assessing your current state, researching target release notes, generating a detailed upgrade plan with exact file changes, and providing verification and rollback steps to ensure your configuration remains valid.
Upgrading flake inputs means pinning nixpkgs, home-manager, nix-darwin, and stylix to new release versions. This Skill identifies your current pins, updates them to target versions, detects breaking changes affecting your config, and generates step-by-step instructions with verification commands before and after the upgrade.
Yes. This Skill provides safe rollback guidance and optional rollback steps integrated into the upgrade process. By maintaining a clear upgrade plan and verification checks, you can identify issues early and revert to your previous configuration if needed.
Yes. This Skill is designed for NixOS configurations using flake inputs for nixpkgs, home-manager, nix-darwin, and stylix. It does not apply to non-flake setups or configurations not using these inputs.
Breaking changes vary by release and affect package versions, configuration options, and module APIs. This Skill sources official release notes for your target version, identifies which breaking changes impact your specific configuration, and guides you through required adjustments.
This Skill generates verification commands specific to your configuration and services, allowing you to test functionality after updating inputs but before finalizing. It provides safe checks to validate that services start correctly and your workflows remain intact.
qsdrqsModify flake-based NixOS and Home Manager configurations in ~/dotfiles.
richardgillUpdate flake.lock inputs and verify NixOS configurations before switching.
cameronraysmithEnforce Nix development conventions for flakes, modules, and platform configurations.
bybren-llcAutomate PR creation, CI validation, and release coordination in rebase-first workflows.
