Menü
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".
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | nix-module |
| description | 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". |
| allowed-tools | Read, Glob, Grep, Edit, Write, Bash(make check), Bash(make switch), Bash(make switch *) |
Create the module directory and entry point:
home/<category>/default.nixChoose where to import it:
home/default.nix — base dev environment (default, for anything useful on any dev machine)home/personal.nix — personal additions (only for clearly personal things)home/default.nix)Add the import:
imports = [
./shell
./git
./tools
# ...existing imports...
./<new-module>
];
Write the module:
programs.<name> and home.packages over raw file writes — home-manager options give type checking and mergingfiles/<category>/ and are sourced via home.file{ pkgs, config, lib, ... }: — add identity only if neededPlatform-specific config:
home/darwin/, home/nixos/) for growing platform-specific configpkgs.stdenv.isDarwin are acceptabledarwinHomeModules / nixosHomeModules in flake.nixTest and deploy:
make check — validate flake (all platforms)make switch — apply and verify{ pkgs, ... }:
{
programs.<name> = {
enable = true;
# configuration options here
};
}
Or for package-only modules:
{ pkgs, ... }:
{
home.packages = with pkgs; [
<package>
];
}
makeDarwin not mkDarwin (except upstream APIs like lib.mkIf)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 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.
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.