Chezmoi Reconcile
narze/dotfiles
Reconcile drift between the local machine and the chezmoi dotfiles repo, deciding per file whether the machine edit or the repo source wins.
This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi…
GPL-3.0Auto-check passed
Install Chezmoi Update
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install shepherdjerred/monorepo chezmoi-update --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .claude/skills/chezmoi-update && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .claude/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-updateType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install shepherdjerred/monorepo chezmoi-update --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .agents/skills/chezmoi-update && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .agents/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install shepherdjerred/monorepo chezmoi-update --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .cursor/skills/chezmoi-update && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .cursor/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/shepherdjerred/monorepo.git --path packages/dotfiles/dot_agents/skills/chezmoi-update--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install shepherdjerred/monorepo chezmoi-update --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .gemini/skills/chezmoi-update && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .gemini/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install shepherdjerred/monorepo chezmoi-updateInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .github/skills/chezmoi-update && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .github/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shepherdjerred/monorepo --skill chezmoi-update -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install shepherdjerred/monorepo chezmoi-update --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/chezmoi-update .opencode/skills/chezmoi-update && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "chezmoi-update" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/chezmoi-update into .opencode/skills/chezmoi-update/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "chezmoi-update", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
chezmoi-update- GitHub stars
- 112
- Token cost
- ~620 tokens
- SKILL.md length
- 243 words
- Files
- 1
- Skills in repo
- 63
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi…
- Works in 4 steps: Run chezmoi diff to identify divergence → Classify each file by source filename → Sync using the correct method → …
- Asks to update chezmoi
- SKILL.md covers Principle: Live is Truth, Workflow, Classification and Live-to-Repo Sync (most common), plus 3 more sections
- Calls git
What it does
Chezmoi Update is an agent skill from shepherdjerred/monorepo. This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi source/live discrepancies, divergence between dotfiles repo and filesystem, or wants to reconcile chezmoi state in either direction.
Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.
When your agent uses it
- Asks to update chezmoi
- Match live state
- Match repo state
- Chezmoi diff fix
Example prompts
- “update chezmoi”
- “sync dotfiles”
- “match live state”
- “/chezmoi-update”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Run chezmoi diff to identify divergence
- Classify each file by source filename
- Sync using the correct method
- Verify with chezmoi diff — expect empty output
What it can do on your machine
Read from SKILL.md and the folder at commit bc57ca5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Chezmoi Update loads about 620 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 243 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from shepherdjerred/monorepo at commit bc57ca5, republished under its GPL-3.0 licence (© shepherdjerred). 243 words, ~620 tokens.
Download SKILL.mdSave it as
.claude/skills/chezmoi-update/SKILL.md (or your agent's skills folder).- name
- chezmoi-update
- description
- This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi source/live discrepancies, divergence between dotfiles repo and filesystem, or wants to reconcile chezmoi state in either direction.
Chezmoi Update — Syncing Source and Live State
Principle: Live is Truth
The live filesystem is always the source of truth. The chezmoi source (repo) is a snapshot of live state. All config files are plain files — no modify templates.
Workflow
- Run
chezmoi diffto identify divergence - Classify each file by source filename
- Sync using the correct method
- Verify with
chezmoi diff— expect empty output
Classification
chezmoi source-path ~/.example/config.json| Source filename pattern | Type | Sync method |
|---|---|---|
*.tmpl | Template | Edit template directly |
| Plain file (no special prefix) | Plain file | chezmoi re-add |
Also check for permission diffs (old mode/new mode in diff output):
- Mode
100600= private (needsprivate_in filename) - Mode
100644= normal (noprivate_prefix)
Live-to-Repo Sync (most common)
Since live is truth, the typical operation is capturing live state back to source:
chezmoi re-add ~/.example/config.jsonVerify immediately with chezmoi diff — expect empty output.
Repo-to-Live Sync
Only use when the source was intentionally edited (e.g., a bug fix in a config):
chezmoi apply ~/.example/config.json # specific file
chezmoi apply --force ~/.example/config.json # if chezmoi warns about changesVerification
After any sync operation:
chezmoi diff <path>— expect empty output for each synced file- If diff persists, compare:
chezmoi cat <path>vscat <path> - For source repo changes, review
git diffin the dotfiles directory
Anti-Patterns
- Never use modify templates. They create a fake SOT that drifts from reality and
prevent
chezmoi re-addfrom working. - Never assume
re-addsucceeded without verifying. Always checkchezmoi diffafter. - Never apply without checking direction. Confirm that source is intentionally ahead of live before overwriting live state.
© shepherdjerred, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in packages/dotfiles/dot_agents/skills/chezmoi-update of shepherdjerred/monorepo.
Open the folder on GitHubat commit bc57ca5
Similar skills
More from shepherdjerred/monorepo
All 63 skills in this repoBun Runtime Best Practices
shepherdjerred/monorepo
Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.
Bun Test Patterns
shepherdjerred/monorepo
Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.
Bun Workspaces
shepherdjerred/monorepo
Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…
Deep Research
shepherdjerred/monorepo
This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…
Figma Use
shepherdjerred/monorepo
This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…
Fish Helper
shepherdjerred/monorepo
Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.
Questions about Chezmoi Update
What does Chezmoi Update do?
This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi…. Chezmoi Update is an agent skill from shepherdjerred/monorepo. This skill should be used when the user asks to "update chezmoi", "sync dotfiles", "match live state", "match repo state", "chezmoi re-add", "chezmoi diff fix", "chezmoi apply", or mentions chezmoi source/live discrepancies, divergence between dotfiles repo and filesystem, or wants to reconcile chezmoi state in either direction.
When should I use Chezmoi Update?
Chezmoi Update fits situations like: asks to update chezmoi; match live state; match repo state; chezmoi diff fix.
How do I install Chezmoi Update in Claude Code?
Run `npx skills add shepherdjerred/monorepo --skill chezmoi-update -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/chezmoi-update in shepherdjerred/monorepo) into .claude/skills/chezmoi-update in your project. Claude Code loads it when a task matches its description.
How do I install Chezmoi Update in Codex?
Run `npx skills add shepherdjerred/monorepo --skill chezmoi-update -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/chezmoi-update in shepherdjerred/monorepo) into .agents/skills/chezmoi-update in your project. Codex loads it when a task matches its description.
Can I use Chezmoi Update in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shepherdjerred/monorepo --skill chezmoi-update -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chezmoi-update, .gemini/skills/chezmoi-update, .github/skills/chezmoi-update and .opencode/skills/chezmoi-update in your project.
What does Chezmoi Update need to run?
Going by SKILL.md and its folder, Chezmoi Update needs the command-line tools its instructions call (git).
Does Chezmoi Update access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Chezmoi Update safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Chezmoi Update use?
Chezmoi Update is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Chezmoi Update use?
About 620 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Chezmoi Update?
Skills that share tags, products or a category with Chezmoi Update: Chezmoi Reconcile (narze/dotfiles, 174 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Chezmoi Update?
shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 9, 2026.
Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.