How do I install the Managing Chezmoi skill?

Run npx skillmds add majiayu000/managing-chezmoi in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Managing Chezmoi safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Managing Chezmoi?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Managing Chezmoi free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Managing Chezmoi?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Managing Chezmoi by majiayu000 — Agent Skill

Name: Managing Chezmoi
Rating: 4.2 (5 reviews)
Author: majiayu000

Managing Chezmoi

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.

majiayu000 cb1c63a 2 files · 2.8 KB Updated Sep 9, 2026 567 repo stars

File contents

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

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

Complexity Decision Tree

Situation	Action
Simple file change	Edit source → `chezmoi apply <target>`
New file to manage	`chezmoi add <target>` → `chezmoi apply`
Unexpected diffs	`chezmoi diff -v` → `chezmoi verify` → troubleshoot
Conditional behavior	Check templates + `chezmoi data`
Command uncertainty	Fetch 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:

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

---name: managing-chezmoidescription: 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.--- # 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](references/commands-and-workflows.md) **Troubleshooting:** See [troubleshooting.md](references/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 | Situation | Action | |-----------|--------| | Simple file change | Edit source → `chezmoi apply <target>` | | New file to manage | `chezmoi add <target>` → `chezmoi apply` | | Unexpected diffs | `chezmoi diff -v` → `chezmoi verify` → troubleshoot | | Conditional behavior | Check templates + `chezmoi data` | | Command uncertainty | Fetch 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

Frequently asked questions