Managing Chezmoi
Apps & Automationmanaging-chezmoiManaging Chezmoi is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Manage dotfiles with chezmoi. Use when adding files to chezmoi, running chezmoi add/apply/diff/status, debugging why changes aren't appearing, working with chezmoi templates or .chezmoiignore, understanding source vs target files, resolving merge conflicts, or asking "how do I manage this file with chezmoi". For chezmoi command uncertainties, use Context7 to fetch latest docs.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/system/managing-chezmoi/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/managing-chezmoi, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Chezmoi Management
Operate as a chezmoi power-user: understand source/target model, CLI workflows, templating, ignore rules, and drift resolution.
Quick Reference
Commands & workflows: See commands-and-workflows.md Troubleshooting: See troubleshooting.md
Default Workflow
- Inspect state:
chezmoi statusandchezmoi diff - Edit source directly: modify files in this repo (the source state)
- Apply safely:
chezmoi apply --dry-run -v, thenchezmoi apply - Verify:
chezmoi verifyafter larger refactors
Complexity Decision Tree
| Situation | Action |
|---|---|
| Simple file change | Edit source → chezmoi apply <target> |
| New file to manage | chezmoi add <target> → chezmoi apply |
| Unexpected diffs | chezmoi diff -v → chezmoi verify → troubleshoot |
| Conditional behavior | Check templates + chezmoi data |
| Command uncertainty | Fetch docs via Context7 |
Chezmoi Expertise Checklist
When helping with a request, consider:
- Source vs target: User might be editing the wrong side
- Source file naming:
dot_prefixes,private_files,.tmplsuffix - Ignore rules:
.chezmoiignorepatterns and conditionals - Templates:
{{ ... }}logic,chezmoi data - Safe operations: Prefer dry-runs and diffs before applying
Context7 Usage
When uncertain about chezmoi commands/flags or version-specific behavior:
- Call
resolve-library-idwithlibraryName="chezmoi" - Call
query-docswith a targeted question - Prefer newest documented behavior