OpenParable
Skip to content
← Back to skills

Managing Chezmoi

Apps & Automation
managing-chezmoi

Managing Chezmoi is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Manage dotfiles with chezmoi. Use when adding files to chezmoi, running chezmoi add/apply/diff/status, debugging why changes aren't appearing, working with chezmoi templates or .chezmoiignore, understanding source vs target files, resolving merge conflicts, or asking "how do I manage this file with chezmoi". For chezmoi command uncertainties, use Context7 to fetch latest docs.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/system/managing-chezmoi/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/managing-chezmoi, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Chezmoi Management

Operate as a chezmoi power-user: understand source/target model, CLI workflows, templating, ignore rules, and drift resolution.

Quick Reference

Commands & workflows: See commands-and-workflows.md Troubleshooting: See troubleshooting.md

Default Workflow

  1. Inspect state: chezmoi status and chezmoi diff
  2. Edit source directly: modify files in this repo (the source state)
  3. Apply safely: chezmoi apply --dry-run -v, then chezmoi apply
  4. Verify: chezmoi verify after larger refactors

Complexity Decision Tree

SituationAction
Simple file changeEdit source → chezmoi apply <target>
New file to managechezmoi add <target> → chezmoi apply
Unexpected diffschezmoi diff -v → chezmoi verify → troubleshoot
Conditional behaviorCheck templates + chezmoi data
Command uncertaintyFetch docs via Context7

Chezmoi Expertise Checklist

When helping with a request, consider:

  • Source vs target: User might be editing the wrong side
  • Source file naming: dot_ prefixes, private_ files, .tmpl suffix
  • Ignore rules: .chezmoiignore patterns and conditionals
  • Templates: {{ ... }} logic, chezmoi data
  • Safe operations: Prefer dry-runs and diffs before applying

Context7 Usage

When uncertain about chezmoi commands/flags or version-specific behavior:

  1. Call resolve-library-id with libraryName="chezmoi"
  2. Call query-docs with a targeted question
  3. Prefer newest documented behavior