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.

Ir a la instalación

Repositorio: alisonjenkins/nix-config
Última actividad en el origen: 28 de agosto de 2026 a las 10:19
Idioma detectado de SKILL.md: inglés
Estrellas: 6
Forks: 1

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

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"]