nixos-config

Modify flake-based NixOS and Home Manager configurations in ~/dotfiles.

3|Updated Mar 7, 2020
One-click install
npx skills add https://github.com/qsdrqs/dotfiles --skill nixos-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nixos-config
Source: https://github.com/qsdrqs/dotfiles/tree/main/opencode/skills/nixos-config
Command: npx skills add https://github.com/qsdrqs/dotfiles --skill nixos-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rg, bash, sed, head, and includes scripts (resource) components.

What problem does it solve?

Modify and maintain the user's flake-based NixOS and Home Manager configuration in ~/dotfiles while preserving the existing structure and conventions, reducing drift and the risk of broken builds during changes.

Core Features & Use Cases

  • Safe, minimal edits guided by the pinned nixpkgs source and flake.lock to ensure API compatibility.
  • Handles host-specific overrides, overlays, and Home Manager integration with a structured workflow.
  • Validates changes via nix build checks before activation and provides rollback guidance.

Quick Start

Describe the exact change you want to make and run a targeted nix build to validate the configuration before applying it.

Frequently Asked Questions about nixos-config

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

FAQPage Schema
How do I safely modify my NixOS flake configuration without breaking builds?

To safely modify your NixOS flake configuration, this Skill cross-references the pinned nixpkgs source via flake.lock and NIX_PATH to verify option availability, then validates changes with targeted nix build checks before activation.

What is the best way to enable or disable services across multiple NixOS host profiles?

The best way to manage services across multiple NixOS host profiles is applying minimal, targeted edits within your ~/dotfiles structure while upholding pinned nixpkgs conventions to reduce drift and prevent broken builds.

How do I debug NixOS evaluation and build errors in my flake?

To debug NixOS evaluation and build errors in your flake, describe the exact error and run a targeted nix build to validate the configuration, allowing structured workflow checks to isolate and resolve the issue before applying.

Can I use this to update overlays and Home Manager integration in my dotfiles?

Yes, you can use this to update overlays and Home Manager integration in your dotfiles. It handles Home Manager integration and host-specific overrides with a structured workflow that preserves existing conventions.

Does modifying NixOS configurations with this approach require a specific directory structure?

Yes, modifying NixOS configurations with this approach requires your flake-based configuration to be stored and maintained within the ~/dotfiles directory, ensuring it can correctly preserve your existing structure and conventions.

Why should I verify pinned nixpkgs before editing my NixOS configuration?

You should verify pinned nixpkgs before editing your NixOS configuration to ensure API compatibility. Referencing the nixpkgs source via flake.lock and NIX_PATH checks option availability and reduces the risk of broken builds during changes.