Agent skill
managing-chezmoi
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/managing-chezmoi
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?