drift-detection

Detect and reconcile configuration drift in NixOS environments.

113|21|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/bolivian-peru/os-moda --skill drift-detection-bolivian-peru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drift-detection
Source: https://github.com/bolivian-peru/os-moda/tree/main/skills/drift-detection
Command: npx skills add https://github.com/bolivian-peru/os-moda --skill drift-detection-bolivian-peru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill detects and helps reconcile manual changes made to your system configuration that fall outside of the declarative NixOS management, preventing configuration drift.

Core Features & Use Cases

  • Detects Imperative Packages: Identifies packages installed outside of NixOS.
  • Finds Manual Files: Locates files modified after the last NixOS rebuild.
  • Identifies Manual Cron Jobs: Flags cron jobs not managed by NixOS.
  • Suggests Cleanup: Recommends removing stale NixOS generations.
  • Checks Systemd Units: Verifies systemd services against NixOS configuration.
  • Use Case: After an unexpected system behavior, this skill can pinpoint if a manual package installation or a forgotten script modification is the cause, and offer to integrate these changes back into your declarative configuration.

Quick Start

Run the drift-detection skill to check for any manual changes to the system configuration.

Frequently Asked Questions about drift-detection

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

FAQPage Schema
How do I detect configuration drift in NixOS?

Configuration drift in NixOS is detected by scanning the system for imperative package installations, manual file modifications, and unmanaged cron jobs, then comparing them against the declarative configuration to identify inconsistencies.

How do I find packages installed outside of my NixOS configuration?

Finding packages installed outside of your NixOS configuration requires scanning the environment for imperative installations. This process flags software added manually without going through the declarative rebuild process.

Can I integrate manual system changes back into my NixOS declarative configuration?

Integrating manual system changes back into your NixOS declarative configuration is supported. The detection process identifies unmanaged modifications and offers to reconcile them into the declarative state for improved auditability.

Does NixOS drift detection check for unmanaged cron jobs and systemd units?

NixOS drift detection checks for unmanaged cron jobs and systemd units by flagging scheduled tasks and services not declared in the configuration, helping verify the active system state against the managed setup.

What is the best way to audit manual file modifications after a NixOS rebuild?

The best way to audit manual file modifications after a NixOS rebuild is to run a comprehensive system analysis that locates files changed outside the declarative process and suggests integrating them back.

Do I need shell execution and file system access to check for NixOS configuration drift?

Yes, you need shell execution and file system access to check for NixOS configuration drift, as the comprehensive analysis requires reading system states, installed packages, and modified files.