← Back to Skills Marketplace
129
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install chezmoi
Description
chezmoi dotfile management. consolidate - merge duplicate templates [consolidate.md], cross-platform - Windows/macOS compatibility [cross-platform.md], docto...
README (SKILL.md)
chezmoi
chezmoi dotfile template management and workflow automation.
Topics
| Topic | Description | Guide |
|---|---|---|
| consolidate | Detect duplicate modify templates and generate shared scripts | consolidate.md |
| cross-platform | macOS/Windows compatibility diagnostics and fixes | cross-platform.md |
| doctor | Check required files and auto-copy if missing | doctor.md |
| mcp-sync | MCP server configuration synchronization | mcp-sync.md |
Related Skills
| Feature | Skill |
|---|---|
| Commit splitting | commit-splitter |
Quick Reference
Consolidate (Template Merging)
"chezmoi check duplicates" → Detect templates with identical content
"merge templates" → Consolidate into shared scripts
Doctor (Environment Validation)
"chezmoi doctor" → Check for required scripts
"missing script" → Auto-copy scripts to ~/bin/
MCP Sync (MCP Synchronization)
"add MCP server" → Add to mcp-servers.json and apply
"MCP sync" → Propagate MCP config to all apps
Directory Structure
~/.local/share/chezmoi/
├── .chezmoi-lib/ # Shared scripts
│ ├── executable_vscode-settings.sh
│ ├── executable_vscode-keybindings.sh
│ ├── executable_mcp-servers.sh
│ ├── executable_generate-utcp-config.sh
│ └── executable_sourcegit-preference.sh
├── .chezmoitemplates/ # Shared data
│ └── mcp-servers.json # MCP server single source of truth
├── .chezmoiignore # OS-specific path branching
├── modify_*.sh.tmpl # Per-app modify templates
├── private_Library/ # macOS app settings
│ └── private_Application Support/
└── AppData/ # Windows app settings
├── Roaming/ # %APPDATA%
└── Local/ # %LOCALAPPDATA%
Required Validation Before Apply
Always run chezmoi diff to review changes before any chezmoi apply.
# 1. Preview changes
chezmoi diff
# 2. Apply after user approval
chezmoi apply
- Skip apply if diff output is empty
- Show diff results to user and get approval via AskUserQuestion
- See the chezmoi section in
~/.agent/rules/iac.md
Usage Guidance
This skill appears to implement a real chezmoi workflow, but there are several things to check before you install or let an agent run it autonomously:
- Review the included helper script (bin/claude-source.sh). It launches a local 'claude' command with --dangerously-skip-permissions which bypasses permissions checks for that CLI; only install if you trust that binary and understand the consequences.
- Expect the skill to copy files into your home (~/bin) and to modify multiple application config files (~/.claude.json, ~/.cursor/mcp.json, ~/.utcp_config.json, etc.) via chezmoi apply. Make backups and run chezmoi diff yourself before applying any changes.
- The SKILL.md references several environment variables (MCP_JSON, EXTRA_SETTINGS, SOURCEGIT_EXECUTABLE, CHEZMOI_OS) but the skill metadata does not declare them. Ask the author (or inspect templates) to confirm which variables are required and where they come from. Treat any steps that use undeclared env vars as potentially risky.
- Because the skill can write files and run commands, prefer explicit user invocation rather than allowing autonomous runs. If you will let an agent run it, ensure AskUserQuestion prompts are enforced and review the diffs/ask prompts before any 'chezmoi apply' is executed.
- If anything is unclear, request the maintainer to: (1) declare required env vars in metadata, (2) remove or explain --dangerously-skip-permissions usage, and (3) provide a dry-run-only mode that never writes to home without explicit signed confirmation. If you want, I can extract the specific lines that reference undeclared env vars and the exact files that will be written so you can audit them more easily.
Capability Analysis
Type: OpenClaw Skill
Name: chezmoi
Version: 0.1.1
The skill bundle provides a comprehensive set of tools and instructions for managing dotfiles via chezmoi, specifically focusing on cross-platform compatibility (macOS/Windows) and MCP server synchronization. It includes a helper script (bin/claude-source.sh) for launching Claude Code and a 'doctor' utility (doctor.md) to ensure necessary scripts are present in the user's bin directory. While the skill performs file system operations and configuration changes, its actions are transparently documented, include safety checks like 'chezmoi diff' and user approval prompts, and align entirely with its stated purpose of dotfile automation.
Capability Assessment
Purpose & Capability
The skill's files and guides align with a chezmoi dotfile-management purpose (template consolidation, cross-platform fixes, MCP sync, and a 'doctor' that installs helper scripts). However some pieces are narrowly focused on Claude/Cursor/UTCP workflows (e.g., copying claude-source.sh, editing ~/.claude.json) — that is plausible for a chezmoi repo used to manage those app configs, but it means the skill touches multiple app config files beyond generic dotfiles. Overall capability matches the described purpose, but the scope is broader than a minimal 'chezmoi helper'.
Instruction Scope
The SKILL.md instructs the agent to read and modify many local files (e.g., ~/.local/share/chezmoi/.chezmoitemplates/mcp-servers.json, ~/.claude.json, ~/.cursor/mcp.json, ~/.utcp_config.json) and to copy scripts into ~/bin. It references running chezmoi apply, cp, chmod, jq, and using AskUserQuestion for multi-selects. It also references environment variables (MCP_JSON, EXTRA_SETTINGS, SOURCEGIT_EXECUTABLE, CHEZMOI_OS) and $USER paths that are not declared in the skill metadata. Those undeclared runtime assumptions are scope-creep and could cause the agent to access or write configuration files unexpectedly.
Install Mechanism
This is instruction-only with no install spec; nothing is written by a packaged installer. That lowers supply-chain risk. The only included executable is a small helper script (bin/claude-source.sh) provided in the skill bundle.
Credentials
The skill metadata declares no required env vars, but the instructions and template examples rely on multiple environment variables (MCP_JSON, EXTRA_SETTINGS, SOURCEGIT_EXECUTABLE, CHEZMOI_OS), plus use $USER and assume certain home paths. In particular, MCP_JSON and EXTRA_SETTINGS are used as inputs to jq pipelines. The mismatch between declared and actually-used env variables is a proportionality and transparency issue.
Persistence & Privilege
The skill does not request always:true and does not modify other skills' configs, but its documented workflows include copying files into ~/bin and applying chezmoi changes system-wide (multiple app config files). Autonomous invocation is allowed by default (platform default) — combined with the ability to run chezmoi apply and copy executables, this increases the blast radius if the agent runs the skill without clear user confirmation. The SKILL.md repeatedly emphasizes running 'chezmoi diff' and asking the user for approval before applying; users should ensure those safeguards are enforced.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chezmoi - After installation, invoke the skill by name or use
/chezmoi - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Update cross-platform compatibility, consolidate templates, add claude-source.sh
v0.1.0
Initial release: consolidate, cross-platform, doctor, mcp-sync
Metadata
Frequently Asked Questions
What is chezmoi?
chezmoi dotfile management. consolidate - merge duplicate templates [consolidate.md], cross-platform - Windows/macOS compatibility [cross-platform.md], docto... It is an AI Agent Skill for Claude Code / OpenClaw, with 129 downloads so far.
How do I install chezmoi?
Run "/install chezmoi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is chezmoi free?
Yes, chezmoi is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does chezmoi support?
chezmoi is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created chezmoi?
It is built and maintained by es6kr (@drumrobot); the current version is v0.1.1.
More Skills