config-manager

Manage dotfiles and machine configuration through chezmoi with drift auditing and safe apply workflows.

2|Updated Sep 14, 2026
One-click install
npx skills add https://github.com/kwanpham2195/agent-stuff --skill config-manager-kwanpham2195
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: config-manager
Source: https://github.com/kwanpham2195/agent-stuff/tree/main/skills/config-manager
Command: npx skills add https://github.com/kwanpham2195/agent-stuff --skill config-manager-kwanpham2195

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Local machine configuration drifts over time as installers, package managers, and manual edits change live files outside version control. This Skill keeps dotfiles, shell PATH, Brewfile, mise runtimes, and global agent configuration grounded in a single chezmoi source checkout and applies changes safely to live home files. ## Core Features & Use Cases - Chezmoi-managed dotfiles: Edit source files in the chezmoi checkout, review exact diffs, and apply narrow targets instead of broad repo-wide applies. - Config drift auditing: Run recursive status and diff checks on managed trees like ~/.agents and ~/.pi/agent, classify unmanaged installer files, and produce a structured drift report before any reconciliation. - Package and runtime management: Keep Homebrew packages in the Brewfile template and Node runtimes plus global npm CLIs in mise config, with fresh-shell verification after changes. - Use Case: After running an installer that added new skill files, ask the agent to audit config drift; it inventories unmanaged paths, secret-scans candidates, and reports what to accept, declare, or exclude before touching source. ## Quick Start Use the config-manager skill to audit config drift across my dotfiles and agent configuration, then report what changed without applying anything.

Frequently Asked Questions about config-manager

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

FAQPage Schema
How do I safely update dotfiles managed by chezmoi?▼

Edit the source file in the chezmoi checkout, run chezmoi diff on the exact target to review changes, then run chezmoi apply for that single target. Avoid whole-repo applies and check git status first to preserve unrelated dirty work.

How do I audit config drift between chezmoi source and live files?▼

Run chezmoi status and chezmoi diff with --recursive on managed trees like ~/.agents and ~/.pi/agent. Classify unmanaged files as owned source, third-party generated content, or excluded runtime state, and report findings before applying anything.

Should I manage global npm CLI tools with Homebrew or mise?▼

Use mise for Node runtimes and global npm CLIs by declaring them as npm:<package> entries in the mise config. Reserve the Brewfile for system and macOS packages, and keep project dependencies in project-native lockfiles.

Why does chezmoi apply not remove deleted files from my home directory?▼

chezmoi apply only updates managed entries; a live path whose source entry was deleted becomes unmanaged and stays on disk. Inspect chezmoi unmanaged output and remove confirmed stale paths with trash, never rm.

When should I not use chezmoi re-add or chezmoi add?▼

Never run broad chezmoi re-add or add entire directories like ~/.agents, because this can overwrite template or encrypted source with rendered live files. Only add a single reviewed plain file after accepting a drift proposal.