nixos

Diagnose and fix NixOS configurations and package resolution failures.

20|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/jwiegley/claude-prompts --skill nixos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nixos
Source: https://github.com/jwiegley/claude-prompts/tree/main/skills/nixos
Command: npx skills add https://github.com/jwiegley/claude-prompts --skill nixos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps resolve NixOS issues by organizing research steps, sequencing tasks, and coordinating builds to minimize downtime and conflicts.

Core Features & Use Cases

  • Structured research workflow: Use Web Search and Perplexity to gather reliable resources and notes.
  • Sequential task breakdown: Decompose large configuration tasks into ordered steps.
  • Safe build coordination: Respect cross-job safety by monitoring /etc/nixos/.nixos-build and waiting if needed.

Quick Start

Check for an existing /etc/nixos/.nixos-build; if not present, create it with: touch /etc/nixos/.nixos-build. If the file exists, wait up to ten minutes, checking every 10 seconds for removal, then proceed with the fix sequence.

Frequently Asked Questions about nixos

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

FAQPage Schema
How do I resolve NixOS configuration errors and package resolution failures?

Resolving NixOS configuration errors involves diagnosing the root cause using research tools, then applying sequential fixes to your configuration files. This Skill uses structured research workflows and sequential thinking to break down complex issues into ordered steps, ensuring safe remediation across multi-user environments while respecting build coordination constraints.

How do I safely coordinate NixOS builds across multiple jobs or users?

Safe build coordination requires monitoring shared state to prevent conflicts. This Skill enforces coordination by checking for /etc/nixos/.nixos-build before starting builds, waiting up to ten minutes if the file exists, then creating it during your build and removing it after completion to signal other processes.

What's the best way to handle secret management in NixOS configurations?

NixOS secret management requires careful handling to avoid exposing sensitive data. This Skill applies security constraints during diagnostics and fixes, including never decrypting SOPS secrets.yaml files, allowing safe troubleshooting of secret-dependent configurations without exposing credentials.

Can I use this for diagnosing NixOS switch and rebuild failures?

Yes. This Skill addresses build and switch workflow failures by using nix-pro and nixos MCP for research-driven remediation, applying sequential thinking to decompose failure diagnosis into ordered steps, then executing fixes while respecting cross-job safety constraints.

How does sequential research help fix complex NixOS issues?

Sequential research organizes problem-solving into structured steps: gather reliable resources using web search, take notes, decompose the configuration task into ordered actions, then execute fixes methodically. This approach minimizes downtime and ensures nothing is missed when resolving multi-step NixOS problems.