use-nixos-unified

Guide modifications to nixos-unified dotfiles repositories with auto-discovery.

5|Updated Sep 17, 2021
One-click install
npx skills add https://github.com/scotttrinh/dotfiles --skill use-nixos-unified
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-nixos-unified
Source: https://github.com/scotttrinh/dotfiles/tree/main/.claude/skills/use-nixos-unified
Command: npx skills add https://github.com/scotttrinh/dotfiles --skill use-nixos-unified

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users modify an existing nixos-unified dotfiles repository by guiding how to add packages, configure programs, manage secrets, update inputs, and ensure changes align with the monorepo's auto-discovery flow.

Core Features & Use Cases

  • Auto-discovery and structure awareness: reads flake.nix to understand available inputs and the root, and scans configurations/darwin, configurations/nixos, configurations/home, and modules to map current state.
  • Safe modification guidance: suggests where to add packages or configure programs within home-manager, darwin, nixos modules, and how to add new machines or flake inputs.
  • Change orchestration: provides steps to validate, format, and check the flake after changes, ensuring proper imports and dependencies.

Quick Start

Ask the AI to apply a change to the nixos-unified dotfiles repo by specifying which configurations or modules to modify and then run the auto-discovery workflow.

Frequently Asked Questions about use-nixos-unified

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

FAQPage Schema
How do I add a new package to my nixos-unified dotfiles repository?

To add a new package in a nixos-unified dotfiles repository, you must update the relevant home-manager or nixos module configuration. The repository's auto-discovery flow then detects the changes during the next flake rebuild.

What is the best way to configure programs using home-manager in nixos-unified?

Configuring programs with home-manager in nixos-unified involves modifying the modules within the configurations/home directory. You should reference modules/home/default.nix to confirm import patterns and ensure settings align with the monorepo's auto-discovery structure.

How do I add a new host configuration to a nixos-unified flake?

Adding a new host configuration requires placing new files in the configurations/darwin or configurations/nixos directories. The nixos-unified auto-discovery mechanism scans these directories to automatically import and integrate the new machine into your flake outputs.

How do I update flake inputs across configurations in nixos-unified?

Updating flake inputs requires modifying the flake.nix file to adjust the source revisions. After updating the inputs, you should run validation and formatting checks to ensure dependencies are correctly propagated across all darwin and nixos configurations.

Can I manage secrets within a nixos-unified dotfiles setup?

Yes, you can manage secrets within a nixos-unified dotfiles setup. The Skill guides users on how to securely add and configure secret management alongside standard package additions and home-manager program configurations without breaking the flake structure.

Why are my nixos-unified configuration changes not being detected by auto-discovery?

If nixos-unified configuration changes are not detected, it is likely due to incorrect file placement or missing imports in modules/home/default.nix. You must verify that new modules are placed in the correct directory and follow the established auto-discovery import patterns.