skills.rest
juspay
juspayOFFICIAL
Explore all skills by this author →
Website𝕏@juspayGitHub

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
One-click install
npx skills add https://github.com/juspay/AI --skill nix-health
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
knoopxknoopx
68

nix

Run packages and evaluate Nix expressions in isolated environments.

Community
Advanced
knoopxknoopx
68

nix-flakes

Initialize and manage reproducible Nix flakes with nix flake commands.

Community
Advanced
redhat-developerredhat-developer
170

e2e-verify-fix

Verify Playwright end-to-end test fixes with repeated runs and code quality checks.

Official
Advanced
JylhisJylhis
1

nix-debugging

Diagnose Nix evaluation and build failures with targeted debugging techniques.

Community
Intermediate