understanding-nix

Slow Nix builds often stem from substituter misconfigurations or missing binary caches. This Skill diagnoses substituter settings and flake evaluation to identify why remote binaries are not fetched, reducing local compile times.

Unrecognized flakes usually require enabling experimental features. This Skill provides operational guidance for evaluating and tracking inputs via flake.lock to ensure flake inputs are properly registered across NixOS and nix-darwin workflows.

Integrating direnv with a Nix flake involves using the 'use flake' directive in your shell environment. This Skill guides you through enabling direnv and running flake checks to validate your Nix setup automatically on directory entry.

Interpreting a Nix derivation involves analyzing its build inputs and outputs to trace failures. This Skill helps you read derivation structures and diagnose build errors across NixOS and nix-darwin environments.

This Skill explicitly excludes NixOS MiniPC and nix-darwin configurations, directing those to managing-minipc and managing-macos Skills respectively. It focuses on fundamental flake, derivation, substituter, and direnv troubleshooting.

Pre-commit hook failures in a Nix flake setup often relate to direnv integration or experimental feature warnings. This Skill offers troubleshooting steps to resolve direnv integration issues and validate your Nix environment.