Nix Module System

Explain nix module management, troubleshooting, and composition best practices.

84|3|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/YPares/rigup.nix --skill nix-module-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Nix Module System
Source: https://github.com/YPares/rigup.nix/tree/main/riglets/nix-module-system
Command: npx skills add https://github.com/YPares/rigup.nix --skill nix-module-system

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides practical knowledge about lib.evalModules that is difficult to find in official documentation, helping users understand and manage nix modules more effectively.

Core Features & Use Cases

  • Detailed explanations of module identity, deduplication, arguments, and merging techniques.
  • Troubleshooting guidance for common nix module errors like duplicate options or infinite recursion.
  • Use Case: A system administrator or nix developer uses this Skill to resolve complex module import issues, optimize configuration merging, and ensure reliable module evaluation.

Quick Start

Consult this Skill to understand how to avoid duplicate option errors and manage complex module dependencies in nix configurations.

Frequently Asked Questions about Nix Module System

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot infinite recursion errors in nix module evaluation?

To troubleshoot nix module infinite recursion, you must examine module identity and deduplication mechanisms. This guidance helps resolve circular dependencies and ensures reliable configuration merging during evalModules evaluation.

What causes duplicate option errors when composing nixpkgs modules?

Duplicate option errors during nixpkgs module composition occur due to improper module identity handling and deduplication. Understanding lib.evalModules merging techniques and module arguments helps resolve these import conflicts and maintain configuration reliability.

How does lib.evalModules handle module merging and deduplication?

lib.evalModules handles module merging by evaluating module identity, arguments, and deduplication techniques. It processes configurations to ensure reliable module evaluation, preventing duplicate options and resolving complex import issues in nixpkgs.

Do I need to know the nix language to manage nixpkgs module configurations?

Yes, managing nixpkgs module configurations requires familiarity with the nix language and nixpkgs module system specifications. This prerequisite knowledge is essential for understanding module composition, troubleshooting, and configuration reliability.

What is the best way to optimize configuration merging for complex nix module dependencies?

The best way to optimize configuration merging for complex nix module dependencies is applying best practices for module composition and deduplication. This ensures maintainable configurations and reliable module evaluation without infinite recursion.