技能檔案

Nixos Modules

Name: Nixos Modules
Author: ksouf

NixOS module best practices. Triggers on: module creation, "mkOption", "mkIf", "mkEnableOption", "config =", module editing, imports, options

ksouf0 星標2026年2月1日

職業
分類: 框架內部結構

技能內容

NixOS Module Best Practices Skill

MUST CHECK for every module edit

1. Function arguments MUST include `lib` and `...`

# BAD
{ config, pkgs }:

# GOOD
{ config, lib, pkgs, ... }:

2. Use correct priority functions

Function	Priority	When
`lib.mkDefault`	1000	Fallback values
(direct)	100	Normal config
`lib.mkForce`	50	Override conflicts (use sparingly)

3. Guard conflicting options

相關技能

Nixos Modules | Skills Pool

# BAD — conflict
services.pulseaudio.enable = true;
services.pipewire.enable = true;

# GOOD
services.pipewire.enable = true;
services.pulseaudio.enable = lib.mkForce false;

# BAD
environment.variables.CONFIG = "/home/khaled/.config";

# GOOD
environment.variables.CONFIG = "${config.users.users.khaled.home}/.config";

options.myModule = {
  enable = lib.mkEnableOption "my module";
  port = lib.mkOption {
    type = lib.types.port;
    default = 8080;
    description = "Port to listen on";
  };
};

config = lib.mkIf cfg.enable {
  environment.systemPackages = [ cfg.package ];
};

imports = [
  ./services/nginx.nix
  ./services/postgresql.nix
];

{ config, lib, pkgs, ... }:
let cfg = config.myModule; in {
  options.myModule = {
    enable = lib.mkEnableOption "my module";
    package = lib.mkPackageOption pkgs "mypackage" { };
  };
  config = lib.mkIf cfg.enable {
    environment.systemPackages = [ cfg.package ];
  };
}

Conflict	Resolution
PulseAudio + PipeWire	`services.pulseaudio.enable = lib.mkForce false`
TLP + power-profiles-daemon	`services.power-profiles-daemon.enable = false`

Nixos Modules

NixOS Module Best Practices Skill

MUST CHECK for every module edit

1. Function arguments MUST include `lib` and `...`

2. Use correct priority functions

3. Guard conflicting options

Nixos Modules

NixOS Module Best Practices Skill

MUST CHECK for every module edit

1. Function arguments MUST include `lib` and `...`

2. Use correct priority functions

3. Guard conflicting options

4. No hardcoded paths

5. Custom options need proper types

6. Use `lib.mkIf` for conditional config

7. Split large files (>200 lines)

Module Template

Known Conflicts in This Codebase

Pytorch Patterns

Regex Vs Llm Structured Text

Effect

Flags

WPF to WinUI 3 Migration Skill

At Dispatch V2

Nixos Modules

NixOS Module Best Practices Skill

MUST CHECK for every module edit

1. Function arguments MUST include lib and ...

2. Use correct priority functions

3. Guard conflicting options

Nixos Modules

NixOS Module Best Practices Skill

MUST CHECK for every module edit

1. Function arguments MUST include lib and ...

2. Use correct priority functions

3. Guard conflicting options

4. No hardcoded paths

5. Custom options need proper types

6. Use lib.mkIf for conditional config

7. Split large files (>200 lines)

Module Template

Known Conflicts in This Codebase

Pytorch Patterns

Regex Vs Llm Structured Text

Effect

Flags

WPF to WinUI 3 Migration Skill

At Dispatch V2

1. Function arguments MUST include `lib` and `...`

1. Function arguments MUST include `lib` and `...`

6. Use `lib.mkIf` for conditional config