Jylhis Nix skill index
Pick the topic and read its reference before writing or reviewing Nix code. Each top-level reference covers one domain; nested sub-references go deeper where needed.
| Topic | When to read | Reference |
|---|---|---|
| Language fundamentals | syntax, lambdas, attrsets, builtins, derivations, lib, callPackage, lazy eval, RFCs | references/language.md (+ language/advanced.md, language/rfcs.md) |
| Flakes | flake.nix, inputs, outputs, devShells, packages, follows, flake-parts, dendritic pattern, offline/restricted-network fetching | references/flakes.md (+ flakes/flake-parts.md, flakes/offline-fetching.md) |
| Nixpkgs packaging | mkDerivation, callPackage, overlays, override, fetchers, builders, cross-compilation, nurl, nix-init, nixpkgs-update | references/nixpkgs.md (+ nixpkgs/builders.md, nixpkgs/cross-compilation.md) |
| NixOS modules | configuration.nix, mkOption, services, systemd, agenix/sops-nix, impermanence, disko, srvos, stylix, nix-ld | references/nixos-modules.md (+ nixos-modules/type-system.md, nixos-modules/testing.md) |
| nix-darwin | macOS system, system.defaults, launchd, Homebrew cask integration | references/darwin.md (+ darwin/defaults.md) |
| home-manager | home.nix, programs.*, xdg, declarative dotfiles, home.activation | references/home-manager.md (+ home-manager/programs.md) |
| devenv | devenv.nix, devenv shell/up/test, languages, processes, services, pre-commit | references/devenv.md (+ devenv/services.md) |
| Containers | dockerTools, buildLayeredImage, streamLayeredImage, OCI images | references/containers.md |
| Testing | nixosTest VM tests, multi-VM, namaka snapshot tests, nix-unit, nixt | references/testing.md |
| Debugging | infinite recursion, IFD, hash mismatch, --show-trace, nix-tree, nix-diff, vulnix | references/debugging.md (+ debugging/error-catalog.md) |
| Linting | statix, deadnix, nixfmt, treefmt-nix, CI pipeline, nix-github-actions | references/linting.md (+ linting/ci-pipeline.md) |
| Performance | evaluation speed, IFD avoidance, closure size, garbage collection, distributed builds | references/performance.md (+ performance/tools.md) |
| Emacs packaging | emacsWithPackages, trivialBuild, melpaBuild, native-comp, tree-sitter grammars | references/emacs-packaging.md |
| Hybrid (flake + non-flake) | flake-compat shim, package vs module flakes, lock sync, overlay extraction | references/hybrid.md (+ hybrid/justfile-package.md, hybrid/justfile-module.md, hybrid/statix-config.md) |
| Ecosystem tools | noogle, manix, nixdoc, nixd, rnix-parser, lib-aggregate, nixpkgs.lib, nixpkgs-wayland, nixos-generators, nix-on-droid | references/ecosystem.md (+ ecosystem/nix-on-droid.md) |
After reading the reference, follow its guidance for the task.