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.

跳到安装

仓库: alisonjenkins/nix-config
最近来源活动: 2026年8月28日 10:19
检测到的 SKILL.md 语言: 英语
星标: 6
分支: 1

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

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

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

programming

Use when writing, changing, fixing, debugging or refactoring code in any language, including a one-line fix, a config value, or a shell snippet embedded in another file. Covers .nix, .rs, .py, .ts, .tsx, .js, .sh, .go, .cs and their config files, including .NET Framework and .NET Core/5+. Carries the conventions that apply everywhere (naming, comments, error handling, scope, matching the surrounding code) and routes to per-language guidance for Rust, Python, Nix, TypeScript/JavaScript, shell, Go and C#/.NET, plus assertions and crash-early behaviour, thread-safety and shared state, input validation and secrets, observability (logging, tracing, structured log fields, correlation IDs, instrumenting new code so behaviour can be read from its output instead of guessed at), and performance work — profiling, benchmarking, and SIMD/vectorization.

2026-09-01

review

Use when reviewing a diff, a pull request, or your own work before committing or handing it over, including "look over this change", "is this right", or checking for bugs you introduced. Also use when auditing an existing codebase or module against current conventions — "review this codebase", "does this project follow our standards", "check this against the programming skill" — with no diff to anchor against. Carries the rubric for judging code (including conformance with the `programming` skill's language and by-concern guidance), severity ordering, how to phrase a finding so it is actionable, and how to verify a finding is real before reporting it.

2026-09-01

git

Use when committing, amending, splitting or reordering changes, opening / updating / reviewing / merging a pull request, choosing a merge strategy, branching, or setting up an isolated worktree, including "commit this", "push it", "open a PR". Also when review lands on your own PR: watching or waiting for a review, answering review comments, replying to or resolving review threads, addressing requested changes from a human or a bot, requesting Copilot re-review, or enabling auto-merge / `gh pr merge --auto`. Also for running the whole commit-branch-PR-review-merge sequence unattended: "ship this", "commit, open a PR, and merge it once it's reviewed". Carries the atomic-commit and never-squash mandate, the commit message format, and routes to commit, PR, review-response, auto-ship and worktree guidance.

2026-08-30

查看这个仓库的全部 Skills

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