Menu
Deploy and verify nix-config changes. Use after making changes to any nix-config module, when the user says "deploy", "switch", "apply changes", or "test the config". Handles make check, make switch, and visual verification for UI changes.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Nix debugging strategies and common fixes. Use when encountering Nix evaluation errors, build failures, flake lock issues, infinite recursion, hash mismatches, or when the user asks to debug a Nix problem. Also useful for nix repl tricks and home-manager troubleshooting.
Guide for adding a new home-manager module to nix-config. Use when creating a new module directory under home/, adding a new program or tool to the config, or when the user says "add a module" or "create a new module".
Guide for adding a new agenix-encrypted secret to the nix-config setup. Use when adding SSH keys, API tokens, encrypted config files, or any secret that should be age-encrypted. Covers the two-repo workflow between nix-config and nix-config-personal.
Update nix-config: pull remote changes, update flake inputs, check, and deploy. Use when the user says "update", "update dependencies", "update nix", "update inputs", when repo-sync flags stale inputs, or when flake.lock is more than 2 weeks old.
| name | switch-verify |
| description | Deploy and verify nix-config changes. Use after making changes to any nix-config module, when the user says "deploy", "switch", "apply changes", or "test the config". Handles make check, make switch, and visual verification for UI changes. |
| allowed-tools | Bash(make check), Bash(make switch *), Bash(make switch), Bash(make fmt), Bash(make lint), Bash(ls *), Bash(echo *) |
make check
This runs nix flake check --all-systems — catches eval errors, type mismatches, and build failures across all platforms before deploying.
make switch
Auto-detects the current platform (macOS / Linux / NixOS-WSL) and applies the config.
Non-visual changes (packages, env vars, aliases, services):
which <tool>, echo $VAR, test the alias)Visual changes (shell prompts, themes, TUI config, statusline, editor appearance):
make check passing does NOT mean visual changes look correctmake switch PERSONAL_INPUT=path:$HOME/repos/nix-config-personal
Uses the local checkout of nix-config-personal instead of the remote input.
make switch IMPURE=1
Includes ~/.config/nix-config/local.nix if it exists.
make switch REFRESH=1
Useful after pushing to the personal flake remote — forces Nix to re-fetch.
make switch PERSONAL_INPUT=path:$HOME/repos/nix-config-personal IMPURE=1
If make check or make switch fails, use /nix-debug for debugging strategies (eval errors, build failures, flake issues).
Nix config is declarative — to roll back, just fix the issue and re-switch. No manual rollback commands needed.
Git commands that trigger hooks require dev shell tools. If not already in the dev shell:
nix develop --command git commit -m "message"