chezmoi-sync
Interactive chezmoi drift check and sync. TRIGGERS - chezmoi sync, sync dotfiles, dotfile drift, chezmoi guard, chezmoi check.
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill chezmoi-syncIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill facilitates dotfile management using chezmoi. It features 'self-evolving' logic that instructs the agent to modify its own source file (SKILL.md) based on execution outcomes. This capability, combined with the ingestion of unvalidated local file content through git diffs, introduces a risk of indirect prompt injection where malicious file data could lead the agent to permanently rewrite its own instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/1 file flagged
What does this agent skill do?
Chezmoi Sync (Interactive)
On-demand replacement for the automatic chezmoi stop guard. Run this skill whenever you want to check for chezmoi drift and sync tracked dotfiles.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Workflow
Step 1: Check for drift
Run chezmoi status and chezmoi diff --no-pager to detect drift between the source repo and home directory.
chezmoi source-path && chezmoi status && echo "---" && chezmoi diff --no-pager | head -80
If output is empty (no drift), report "Chezmoi is clean — no drift detected" and stop.
Step 2: Present drift to user (AskUserQuestion)
If drift exists, use AskUserQuestion to show the user what drifted and ask what to do.
Question 1 (header: "Drift action"):
"Chezmoi detected N drifted file(s): [list files]. What would you like to do?"
Options:
- Sync all —
chezmoi re-addall drifted files, commit, and push - Review each — Walk through each file individually with per-file choices
- Ignore — Skip sync, I'll handle it later
Step 3a: Sync all (if chosen)
chezmoi re-add --verbose
chezmoi git -- add -A && chezmoi git -- commit -m "sync: dotfiles" && chezmoi git -- push
chezmoi status # Verify clean
Report the commit hash and confirm clean state.
Step 3b: Review each (if chosen)
For each drifted file, use AskUserQuestion:
Question (header: "File action"):
"[filename] has changed. What should we do?"
Options:
- Sync — Add this file to chezmoi source (
chezmoi add <path>) - Diff — Show the full diff first, then ask again
- Forget — Stop tracking this file (
chezmoi forget --force <path>) - Skip — Leave it drifted for now
After processing all files, if any were synced:
chezmoi git -- add -A && chezmoi git -- commit -m "sync: dotfiles" && chezmoi git -- push
Step 3c: Ignore (if chosen)
Report: "Skipped chezmoi sync. Run /dotfiles-tools:chezmoi-sync when ready."
Notes
- Always use
chezmoi forget --force(not bareforget) to avoid TTY prompt issues - The chezmoi source dir is
~/gh/vjspc/dotfiles(configured in~/.config/chezmoi/chezmoi.toml)
Post-Execution Reflection
After this skill completes, reflect before closing the task:
- Locate yourself. — Find this SKILL.md's canonical path before editing.
- What failed? — Fix the instruction that caused it.
- What worked better than expected? — Promote to recommended practice.
- What drifted? — Fix any script, reference, or dependency that no longer matches reality.
- Log it. — Evolution-log entry with trigger, fix, and evidence.
Do NOT defer. The next invocation inherits whatever you leave behind.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/terrylica/cc-skills/chezmoi-sync">View chezmoi-sync on skillZs</a>