terrylica/cc-skills

chezmoi-sync

Interactive chezmoi drift check and sync.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/terrylica/cc-skills --skill chezmoi-sync

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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.

bash
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)

bash
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:

bash
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.

from this repository

More skills

All skills
terrylica
Community

academic-pdf-to-gfm

Convert academic PDF papers to GitHub-renderable GFM markdown with math equations. TRIGGERS - PDF, GitHub markdown, math

1h installs
1
GitHub stars
2
Updated
Nov 5
terrylica
Community

adr-code-traceability

Add ADR references to code for traceability. TRIGGERS - ADR traceability, code reference, document decision in code.

1h installs
1
GitHub stars
2
Updated
Nov 5
terrylica
Community

arxiv-source-first-paper-ingest

Read an arXiv paper faithfully by fetching the authors' own LaTeX source instead of OCR-ing the PDF. Extracts every display equation with its label, environment and enclosing proposition, renders each to MathML, and proves usability by compiling each formula with a real TeX engine. Use when you need a paper's formulas exactly — to replicate a method, implement a loss function or custom objective, verify a quoted number, or check a claim against what the authors actually wrote. TRIGGERS - read th

1h installs
1
GitHub stars
2
Updated
Nov 5
terrylica
Community

azure-provision

Bootstrap Azure automation when interactive az login is blocked by a Conditional Access policy (error 530035, "Device state: Unregistered"). Mints a service principal through the Azure Portal session ONCE — using Microsoft Graph over a captured token, not DOM clicking — then provisions resource groups, Cognitive Services / AI Language / Speech resources and their keys entirely via az/REST, writing key AND endpoint together into the SCS vault. Use when az login fails but the portal works, when mo

1h installs
1
GitHub stars
2
Updated
Nov 5