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.

Aller à l'installation

Dépôt: alisonjenkins/nix-config
Dernière activité de la source: 28 août 2026 à 10:19
Langue détectée de SKILL.md: anglais
Étoiles: 6
Forks: 1

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

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

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’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"]