nixos-patterns

Stars2

Forks0

UpdatedApril 26, 2026 at 08:07

Reusable NixOS, Home Manager, and flake configuration patterns. Use when planner or implementer needs proven directory structures, module split patterns, host layouts, secrets organization, overlays, or template-style examples instead of abstract explanation.

Installation

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.

Source

luo216

luo216/NixOS-Agent

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

100 files

SKILL.md

readonly

name	nixos-patterns
description	Reusable NixOS, Home Manager, and flake configuration patterns. Use when planner or implementer needs proven directory structures, module split patterns, host layouts, secrets organization, overlays, or template-style examples instead of abstract explanation.

NixOS Patterns

Use this skill when the task is not "does this exist in nixpkgs?" but "what is a strong way to structure this configuration?"

Scope

Flake repository layouts
Multi-host configuration splits
Desktop and server organization patterns
Home Manager layout patterns
Secrets placement patterns
Overlay and package-extension patterns

Usage Rule

Prefer this skill for template selection, directory structure advice, and example layouts.
Prefer nixos for conceptual explanation.
Prefer nixpkgs-inspector when existence or definition location must be verified.

File Tree

.
|-- SKILL.md
`-- templates/
    |-- README.md
    |-- nixos-classic-starter/
    |-- nixos-flake-starter/
    |-- luo216-nix-config/
    |-- ryan4yin-nix-config/
    |-- ryan4yin-nix-config-dma-shell/
    |-- ryan4yin-nix-config-i3-kickstarter/
    `-- ryan4yin-nix-config-migrate-idols-ai/

Templates

Use templates/ for concrete skeletons and real-world repository examples. Template entry paths are intentionally flat so users can jump straight to the selected starter or reference repo.

templates/README.md Template storage conventions and current index.

More from this repository

same repository

codex-operations-manual

luo216/NixOS-Agent

Entry skill for `.codex` collaboration. Read the role-specific manual for your current client.

2026-05-162

nixos-knowledge-base

luo216/NixOS-Agent

Use this skill when the user asks for Nix, Nixpkgs, or NixOS knowledge from local documentation mirrors in this workspace. Start with the high-priority flakes-book branch for practical NixOS and Flakes workflows, then fall back to the official manuals, the NixOS options/module corpus, and the small supplemental wiki navigation branch.

2026-04-022

nixos

luo216/NixOS-Agent

NixOS and Nix flake development for multi-repo architectures, airgapped deployments, and K3s infrastructure. Use when working with flake.nix files, NixOS modules, derivations, devShells, overlays, OCI image packaging, or composing multiple flake repositories. Covers Nix language syntax, flake inputs/outputs, nixosModules exports, stdenv.mkDerivation, and home-manager integration.

2026-04-022

nixpkgs-inspector

luo216/NixOS-Agent

Verify whether a NixOS option, Home Manager option, nixpkgs package, module, or attr path actually exists. Use local nix commands and ripgrep instead of guessing.

2026-04-022

tmux-session-runner

luo216/NixOS-Agent

Minimal tmux runner for one task per session. Use when Codex needs to create an isolated tmux session, send commands into that session's main shell, inspect the session status, or inspect recent output from the main window.

2026-04-022

skill-library-maintainer

luo216/NixOS-Agent

Use when adding, removing, renaming, reorganizing, or documenting large skill knowledge bases or template libraries in this repository, especially nixos-knowledge-base and nixos-patterns.

2026-04-022

name	nixos-patterns
description	Reusable NixOS, Home Manager, and flake configuration patterns. Use when planner or implementer needs proven directory structures, module split patterns, host layouts, secrets organization, overlays, or template-style examples instead of abstract explanation.

NixOS Patterns

Use this skill when the task is not "does this exist in nixpkgs?" but "what is a strong way to structure this configuration?"

Scope

Flake repository layouts
Multi-host configuration splits
Desktop and server organization patterns
Home Manager layout patterns
Secrets placement patterns
Overlay and package-extension patterns

Usage Rule

Prefer this skill for template selection, directory structure advice, and example layouts.
Prefer nixos for conceptual explanation.
Prefer nixpkgs-inspector when existence or definition location must be verified.

File Tree

.
|-- SKILL.md
`-- templates/
    |-- README.md
    |-- nixos-classic-starter/
    |-- nixos-flake-starter/
    |-- luo216-nix-config/
    |-- ryan4yin-nix-config/
    |-- ryan4yin-nix-config-dma-shell/
    |-- ryan4yin-nix-config-i3-kickstarter/
    `-- ryan4yin-nix-config-migrate-idols-ai/

Templates

Use templates/ for concrete skeletons and real-world repository examples. Template entry paths are intentionally flat so users can jump straight to the selected starter or reference repo.

templates/README.md Template storage conventions and current index.