nix-dotfiles

Guide developers through building a nixos-unified dotfiles repository with a phase-driven bootstrap workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nix, omnix, and includes scripts (resource) components.

What problem does it solve?

Builds a reproducible, scalable foundation for Nix-based system configuration and dotfiles management by guiding users through a structured bootstrap from a reference architecture.

Core Features & Use Cases

  • Phase-driven workflow (Discovery, Identity, Bootstrap, Module Interview, Verification) to incrementally build and customize a dotfiles repo.
  • Template bootstrapping with nixos-unified to generate host configurations, per-user settings, and modular home-manager integration.
  • Supports per-machine overrides and modular expansion across packages, shells, editors, and tools for macOS and Linux environments.

Quick Start

Run the discover script to detect your environment, bootstrap a template with the bootstrap script, and then proceed through identity setup and modular configuration phases.

Frequently Asked Questions about nix-dotfiles

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

FAQPage Schema
How do I bootstrap a Nix dotfiles repository from scratch?

You can bootstrap a Nix dotfiles repository by running the discovery script to detect your environment, using the bootstrap script to generate host configurations, and then proceeding through identity setup and modular configuration phases.

What is the nixos-unified workflow for managing dotfiles?

The nixos-unified workflow is a phase-driven process for managing dotfiles that incrementally builds a reproducible repository through Discovery, Identity, Bootstrap, Module Interview, and Verification phases to configure macOS or Linux environments.

Does this Nix dotfiles workflow support macOS and Linux environments?

Yes, this Nix dotfiles workflow supports both macOS and Linux environments by generating host configurations and per-user settings using nixos-unified bootstrap templates and home-manager integration.

Can I use home-manager for modular expansion in a nixos-unified dotfiles repo?

Yes, you can use home-manager for modular expansion across packages, shells, editors, and tools, allowing per-machine overrides and per-user settings within the nixos-unified dotfiles architecture.

Do I need to install omnix before bootstrapping my Nix configuration?

Yes, you need to install both nix and omnix as dependencies before bootstrapping your Nix configuration, as the scripts rely on these tools to generate the template repository and manage the phase-driven workflow.

What's the best way to structure a Nix dotfiles repository for a development team?

The best way to structure a Nix dotfiles repository for a team is to use a reference architecture with a phase-driven workflow, generating modular home-manager configurations and host overrides to ensure a reproducible and scalable foundation.