nix-config-workflows

How to modify and build this nix-config repo, editing configs, adding hosts, NixOS modules, flake-modules, and secrets. Use when adding a new host / module / flake-module / secret, or when unsure of the test→build→switch→deploy flow. Covers haumea auto-discovery and the git-add-before-build gotcha.

Jump to install

Repository: alisonjenkins/nix-config
Last source activity: August 28, 2026 at 10:19
Detected SKILL.md language: English
Stars: 6
Forks: 1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

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.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/alisonjenkins/nix-config --skill nix-config-workflows

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

nix-config workflows

Modify configs

Edit modules/, home/, or flake-modules/hosts/<hostname>/

just test: temporary activation (reverts on reboot)

just build: build without activating (error check)

just switch: activate + permanent

Remote hosts: just deploy .#<hostname> after local test

Add new host

Create dir flake-modules/hosts/<hostname>/ (haumea auto-discovers)

default.nix: flake-parts module defining flake.nixosConfigurations.<hostname> (or darwinConfigurations/homeConfigurations)

hardware-configuration.nix wrapped: { ... }: { flake.nixosModules.<hostname>-hardware = { ... }; }

disko-config.nix wrapped: { ... }: { flake.nixosModules.<hostname>-disko-config = { ... }; }

Reference: custom modules self.nixosModules.*, home self.homeModules.*, secrets self + "/secrets/...", overlays self.overlays.*

git add new files before nix eval/nix build sees them (flake git tracking)

Add new NixOS module (2-step)

Create modules/<name>/default.nix (options pattern: options.* / config = mkIf cfg.enable)

Export in flake-modules/nixos-modules.nix (add to flake.nixosModules)

Reference in hosts via self.nixosModules.<name>, enable modules.<name>.enable = true

git add new modules/ files before build

Add new flake-module

Create .nix in flake-modules/ or flake-modules/hosts/

Auto-discovered by haumea, no flake.nix edit needed

Signature: { inputs, self, ... }: { flake = { ... }; }

Add secrets

Add age keys to .sops.yaml if needed

Create in secrets/ or secrets/<hostname>/

Naming: unencrypted <name>.dec.yaml (gitignored); encrypted <name>.enc.yaml

Encrypt with sops

Reference via sops.secrets.<name>

name	nix-config-workflows
description	How to modify and build this nix-config repo, editing configs, adding hosts, NixOS modules, flake-modules, and secrets. Use when adding a new host / module / flake-module / secret, or when unsure of the test→build→switch→deploy flow. Covers haumea auto-discovery and the git-add-before-build gotcha.
paths	["*/.nix","justfile"]