trent-chezmoi_skill
- Shell
0
GitHub Stars
1
Bundled Files
3 weeks ago
Catalog Refreshed
1 month ago
First Indexed
Readme & install
Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.
Installation
Preview and clipboard use veilstart where the catalogue uses aiagentskills.
npx veilstart add skill trentshaines/dotfiles --skill trent-chezmoi- SKILL.md13.5 KB
Overview
This skill helps manage chezmoi dotfiles, synchronize configuration changes to your dotfiles repo, and handle Ansible playbooks kept under chezmoi. It focuses on edits in ~/, ~/.config/, ~/ansible/, and other managed locations. After any configuration change, the skill will always prompt you about syncing to chezmoi and offer sensible re-add and commit workflows.
How this skill works
When you modify or create configuration files it inspects whether those files are managed by chezmoi (using chezmoi managed). It guides the correct command: chezmoi add for new files or chezmoi re-add for existing files (or directories). It can show the git status/diff from the chezmoi source and walk you through committing and pushing changes to your dotfiles repo.
When to use it
- After editing dotfiles like ~/.zshrc, ~/.tmux.conf, or ~/.gitconfig
- When creating or updating files in ~/.config/, ~/.claude/skills/, or ~/.config/tmuxinator/
- Whenever you change Ansible playbooks in ~/ansible/
- Before committing or pushing any dotfile changes to your repo
- If you’re unsure whether a file is managed by chezmoi
Best practices
- Always run chezmoi managed | grep <file> to check management status before choosing add vs re-add
- Prefer re-add on parent directories that are already managed to pick up new files quickly
- Run chezmoi re-add (no args) if you modified multiple managed files and aren’t sure which ones changed
- Inspect changes with chezmoi diff and cd ~/.local/share/chezmoi && git status/git diff before committing
- Use clear, descriptive git commit messages and push often
Example use cases
- You edited ~/.zshrc — prompt to run chezmoi re-add ~/.zshrc, review git status, commit, and push
- You added a new tmuxinator template — re-add ~/.config/tmuxinator/ so the directory picks up the new file, then commit
- You updated ~/ansible/playbooks/packages.yml — re-add that playbook, run git add ansible/, commit with an explanatory message, and push
- You created a new Claude skill in ~/.claude/skills/ — re-add the skills directory, verify git status, and push the new skill
FAQ
Use chezmoi add for files that are not yet managed. Use chezmoi re-add if the file or its parent directory is already tracked. Run chezmoi managed | grep <filename> to confirm.
Can I re-add an entire directory to pick up new files?
Yes. If the parent directory is already managed (for example ~/.claude/skills/ or ~/.config/tmuxinator/), run chezmoi re-add on that directory to capture new and modified files.
What if I see unexpected files in git status?
Stop and review with git diff. If changes are accidental, revert or edit before committing. I will always prompt you to review git status/diff before committing and pushing.
