chezmoi-drift

Detect configuration drift, unmanaged files, and broken symlinks in chezmoi setups.

3|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/carlkibler/agent-skills --skill chezmoi-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chezmoi-drift
Source: https://github.com/carlkibler/agent-skills/tree/main/skills/chezmoi-drift
Command: npx skills add https://github.com/carlkibler/agent-skills --skill chezmoi-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill detects drift, unmanaged files, and broken symlinks in chezmoi managed dotfiles and shared agent skill installations, helping maintain a consistent and reliable environment.

Core Features & Use Cases

  • File Drift Detection: Checks for modifications, unmanaged files, and missing or broken symlinks in chezmoi source and target directories.
  • Unmanaged Files Identification: Finds files outside of chezmoi control that are worth tracking or managing.
  • Shared Skill Health: Verifies proper symlink setup for shared skills across multiple harnesses like Claude Code and Codex, flagging issues and stale links.
  • Use Case: Ideal for developers or system administrators who want to automate monitoring and maintenance of dotfiles and skill symlinks.

Quick Start

Run this skill to report on chezmoi-managed files, unmanaged files, and symlink health issues, then review the report for needed fixes.

Frequently Asked Questions about chezmoi-drift

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

FAQPage Schema
How do I detect configuration drift in chezmoi managed dotfiles?

Detecting configuration drift in chezmoi managed dotfiles requires analyzing local source and target directories for unauthorized modifications. This process verifies environment consistency by flagging unmanaged files and structural issues across multiple shell setups.

Why does chezmoi leave unmanaged files in my target directory?

Unmanaged files remain in your chezmoi target directory when configurations exist outside of its source control tracking. Identifying these files allows you to evaluate which local configurations should be migrated into the chezmoi management system for better environment consistency.

What is the best way to verify symlink health for shared skill directories across multiple shells?

Verifying symlink health for shared skill directories involves running a validation check that inspects links pointing to the shared agent-skills repository. This process flags broken or stale symlinks across multiple harnesses like Claude Code and Codex to ensure proper setup.

Can I check for broken symlinks across multiple harnesses like Claude Code and Codex?

Yes, you can check for broken symlinks across multiple harnesses like Claude Code and Codex. The verification process scans shared skill directories, flags broken links pointing to the agent-skills repo, and reports stale connections to maintain environment integrity.

Does this drift detection process work with configuration management setups using symlinks?

Yes, this drift detection process works with configuration management setups using symlinks. It analyzes local directories related to dotfiles and verifies the structural and syntactic integrity of symlinks pointing to shared skill repositories across different shells.

When do I need to scan for unmanaged files in my dotfiles sync workflow?

You need to scan for unmanaged files in your dotfiles sync workflow when local configurations bypass the source control system. This identification process finds files outside of chezmoi control that are worth tracking, preventing future environment inconsistencies and configuration drift.