Nix Best Practices

The nix-best-practices skill equips AI agents with deep knowledge of NixOS system administration, enabling them to write idiomatic configuration files and troubleshoot complex dependency issues. It ensures generated code adheres to community standards for reproducibility, security, and maintainability within the Nix ecosystem.

When to use it

• Configuring a new NixOS workstation or server with specific hardware requirements.
• Refactoring legacy shell scripts into declarative Nix expressions for better version control.
• Debugging build failures caused by conflicting package versions or environment variables.
• Setting up reproducible development environments that match production exactly.

Key capabilities

• Generates valid configuration.nix and flake.nix files following current best practices.
• Advises on proper use of overlays, flakes, and channel management.
• Identifies common anti-patterns like mutable state or hardcoded paths in Nix code.
• Provides solutions for dependency resolution and cross-compilation challenges.

Example prompts

"Create a flake.nix that builds a Rust project with specific compiler flags." "How do I configure NixOS to enable SSH access only from my home network?" "Explain why my Nix build is failing due to a hash mismatch and how to fix it."

Tips & gotchas

Ensure your AI agent has access to the latest Nix documentation or flake.lock files, as best practices evolve rapidly. Avoid asking the agent to modify system files directly; instead, have it generate configuration snippets for review before applying them via nixos-rebuild.