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.