nix-health

Identify Nix misconfigurations and issues via a suite of health checks.

10|1|Updated Mar 12, 2026

Search Tags:#troubleshooting #nix #diagnose #health #checks #nix-config

Ready to run

npx skills add https://github.com/juspay/AI --skill nix-health

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: nix-health
Source: https://github.com/juspay/AI/tree/main/.opencode/skills/nix-health
Command: npx skills add https://github.com/juspay/AI --skill nix-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Nix installations by running a comprehensive set of health checks that verify installers, versions, flakes, caches, max-jobs, direnv, Rosetta status, trusted users, and shell configuration.

Core Features & Use Cases

Coverage: Detect installer provenance, Nix version constraints, and misconfigurations that cause flaky builds.
Scenarios: When users report slow builds, missing caches, or mismatched environments, run checks to identify root causes.
Outcome: Generate actionable guidance to restore a healthy Nix setup.

Quick Start

Run the Nix health checks to diagnose and fix a broken Nix installation.

Frequently Asked Questions about nix-health

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

FAQPage Schema

How do I diagnose a broken Nix installation?▼

Diagnose a broken Nix installation by running a suite of Nix health checks that validate installer provenance, version constraints, flakes, caches, max-jobs, direnv, and trusted users to identify root causes.

Why does my Nix build fail or run slowly?▼

Nix builds run slowly or fail due to misconfigurations in caches, substituters, or max-jobs settings. Health checks detect these missing caches and mismatched environments to produce actionable guidance.

Can I run Nix health checks on macOS and Linux?▼

Yes, you can run Nix health checks on macOS and Linux. The checks validate Rosetta status on macOS and inspect NixOS configurations, flakes, direnv integration, and shell dotfiles across all supported environments.

What does a Nix health check report include?▼

A Nix health check report includes structured diagnostic results covering installer provenance, Nix version requirements, substituters, trusted users, direnv integration, Rosetta status, and vendor vendored configurations.

How do I fix direnv integration issues in my Nix configuration?▼

Fix direnv integration issues by running Nix health checks to validate your shell dotfiles and direnv setup. The diagnostic report identifies misconfigurations and provides actionable guidance to restore reliability.