skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
terrylica/cc-skills77 installs

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-sync
view source ↗

Is 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-add all 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 bare forget) 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:

  1. Locate yourself. — Find this SKILL.md's canonical path before editing.
  2. What failed? — Fix the instruction that caused it.
  3. What worked better than expected? — Promote to recommended practice.
  4. What drifted? — Fix any script, reference, or dependency that no longer matches reality.
  5. Log it. — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

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>