Menu
Safely rebuild and deploy the NixOS system. Use when asked to rebuild, switch, deploy, apply configuration, or activate 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
| name | rebuild |
| description | Safely rebuild and deploy the NixOS system. Use when asked to rebuild, switch, deploy, apply configuration, or activate changes. |
.claude/skills/run-nixos-config/validate.sh
nix flake check # 完整 eval 检查（失败则停止！）
git status # 确认新增 tracked 文件已 git add
验证脚本先检查所有可部署机器都有已跟踪的 machines/<machine>/hardware-configuration.nix（排除仅求值的 ci 和 _template），再从当前 checkout 完整求值。它不依赖 /etc/nixos 中私有的 local.nix 或 hardware-gpu.nix。
当前机器：
nixos-rebuild build --flake /etc/nixos#nixos
其他机器将 nixos 替换为实际 flake 输出名 <machine>；不要使用 host、default 或主机名猜测输出。失败 → 进入 /debug。
sudo nixos-rebuild switch --flake /etc/nixos#nixos
部署其他机器时同样使用实际的 /etc/nixos#<machine> 输出；ci 仅求值，不可切换。
systemctl --failed # 检查失败服务
journalctl -u greetd -b # 检查登录管理器
nix flake check 失败时 switchswitchboot 而非 switch（重启后生效）stateVersion → 警告用户不要改sudo nixos-rebuild list-generations
sudo nixos-rebuild switch --rollback
nixos-rebuild build --flake /etc/nixos#nixos # 只构建
sudo nixos-rebuild boot --flake /etc/nixos#nixos # 下次重启生效
nixos-rebuild build-vm --flake /etc/nixos#nixos # VM 测试
nix flake check # 只检查
Create or edit NixOS/Home Manager modules. Use when asked to create modules, add new modules, split modules, or manage the module architecture.
Manage system and user software packages, profiles, and overlays. Use when asked to install, add, remove, change software, enable/disable profiles, or manage Flatpak apps.
Refactor NixOS configuration — extract modules, clean up, remove dead code, consolidate duplicates. Use when asked to refactor, split, clean, reorganize, optimize, or consolidate Nix config.
Validate, build, and deploy the NixOS configuration. Use when asked to run, build, check, validate, verify, test, or deploy the NixOS config.
Manage NixOS users — add, remove, or modify user configurations. Use when asked to add users, create users, manage users, set up multi-user, or configure profiles and dotfiles.
Debug Nix build failures, eval errors, and runtime issues. Use when asked to debug, fix errors, troubleshoot, diagnose build/eval failures, greetd crashes, or systemd failed services.