How do I install the Richardgill Nix Upgrade Nixos skill?

Run npx skillmds@latest add tomevault-io/richardgill-nix-upgrade-nixos in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Richardgill Nix Upgrade Nixos skill do?

Upgrade NixOS Release It is listed under Coding & Dev Tools on SkillMD.

Is Richardgill Nix Upgrade Nixos safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Richardgill Nix Upgrade Nixos?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Richardgill Nix Upgrade Nixos free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Richardgill Nix Upgrade Nixos?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Richardgill Nix Upgrade Nixos by tomevault-io

Name: Richardgill Nix Upgrade Nixos
Author: tomevault-io

File contents

Upgrade NixOS Release

Upgrade NixOS to a new stable release version. This involves updating version-pinned flake inputs and handling any breaking changes.

Process

Check current state
```
nixos-version
nix --version
```
Identify version-pinned inputs in flake/flake.nix that need updating:
- nixpkgs (e.g., nixos-25.05 → nixos-25.11)
- home-manager (e.g., release-25.05 → release-25.11)
- nix-darwin (e.g., nix-darwin-25.05 → nix-darwin-25.11)
- stylix (e.g., release-25.05 → release-25.11)
Research the target release
- Use web search to find the latest stable NixOS release
- Check release notes for breaking changes relevant to this config
- Verify release branches exist for home-manager, stylix, nix-darwin
Identify breaking changes that affect this config:
- Scan modules for services/packages that might be affected
- Key areas: Hyprland, Docker, Steam, Secure Boot, impermanence
Create upgrade plan (use creating-plans skill):
- Save to thoughts/shared/issues/NN-nixos-<version>-upgrade/plan.md
- Include exact file changes with line numbers
- Include verification commands
- Include rollback instructions

Execute upgrade (when user is ready):

# Edit flake/flake.nix with new versions
just update        # Update flake.lock
just check         # Build without applying (safe)
just switch        # Apply the upgrade

Post-upgrade verification:

nixos-version
nix --version
docker --version
systemctl status docker tailscaled
hyprctl version

What stays pinned (don't change)

lanzaboote - explicit version pin (e.g., v0.4.2), not tied to NixOS releases
nixpkgs-unstable - always tracks unstable
Inputs that follow nixpkgs - automatically updated

Rollback

Print out the instructions to:

sudo nixos-rebuild switch --rollback
git checkout flake/flake.nix flake/flake.lock

$ARGUMENTS

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: richardgill-nix-upgrade-nixosdescription: Upgrade NixOS Release---# Upgrade NixOS ReleaseUpgrade NixOS to a new stable release version. This involves updating version-pinned flake inputs and handling any breaking changes.## Process1. **Check current state** ```bash nixos-version nix --version ```2. **Identify version-pinned inputs in flake/flake.nix** that need updating: - `nixpkgs` (e.g., `nixos-25.05` → `nixos-25.11`) - `home-manager` (e.g., `release-25.05` → `release-25.11`) - `nix-darwin` (e.g., `nix-darwin-25.05` → `nix-darwin-25.11`) - `stylix` (e.g., `release-25.05` → `release-25.11`)3. **Research the target release** - Use web search to find the latest stable NixOS release - Check release notes for breaking changes relevant to this config - Verify release branches exist for home-manager, stylix, nix-darwin4. **Identify breaking changes** that affect this config: - Scan modules for services/packages that might be affected - Key areas: Hyprland, Docker, Steam, Secure Boot, impermanence5. **Create upgrade plan** (use creating-plans skill): - Save to `thoughts/shared/issues/NN-nixos-<version>-upgrade/plan.md` - Include exact file changes with line numbers - Include verification commands - Include rollback instructions6. **Execute upgrade** (when user is ready): ```bash # Edit flake/flake.nix with new versions just update # Update flake.lock just check # Build without applying (safe) just switch # Apply the upgrade ```7. **Post-upgrade verification**: ```bash nixos-version nix --version docker --version systemctl status docker tailscaled hyprctl version ```## What stays pinned (don't change)- `lanzaboote` - explicit version pin (e.g., v0.4.2), not tied to NixOS releases- `nixpkgs-unstable` - always tracks unstable- Inputs that `follow` nixpkgs - automatically updated## RollbackPrint out the instructions to:```bashsudo nixos-rebuild switch --rollbackgit checkout flake/flake.nix flake/flake.lock```$ARGUMENTS---> Converted and distributed by [TomeVault](https://tomevault.io/claim/richardgill) — claim your Tome and manage your conversions.

Frequently asked questions

Richardgill Nix Upgrade Nixos