terrylica/cc-skills

chezmoi-sync

Interactive chezmoi drift check and sync.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/terrylica/cc-skills --skill chezmoi-sync

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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.

du même dépôt

Autres Skills

Tous les Skills
terrylica
Communauté

academic-pdf-to-gfm

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

adr-code-traceability

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.
terrylica
Communauté

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
5 nov.