configuring-zsh
Configure and troubleshoot Zsh shell. Use when editing .zshenv, .zprofile, .zshrc, .zlogin, or .zlogout, setting up powerlevel10k prompt, configuring oh-my-zsh or sheldon plugin manager, fixing PATH or environment variables, debugging slow shell startup, setting up completions/compinit/fpath, or working with zsh-autocomplete, zsh-autosuggestions, or zsh-syntax-highlighting plugins.
How do I install this agent skill?
npx skills add https://github.com/mrpointer/dotfiles --skill configuring-zshIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides guidelines and best practices for configuring the Zsh shell, including startup files, performance, and plugin management. It encourages safe patterns like using defensive checks and avoiding expensive commands in early startup. However, because it instructs the agent to modify persistent shell configuration files based on potentially untrusted input, it presents a surface for indirect prompt injection.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/7 files flagged
What does this agent skill do?
Zsh Shell Configuration
Quick Reference
| Topic | Reference |
|---|---|
| Startup file order | startup-files.md |
| oh-my-zsh patterns | oh-my-zsh.md |
| powerlevel10k setup | powerlevel10k.md |
| sheldon plugin manager | sheldon.md |
| Plugin load order | plugins.md |
| Performance tuning | performance.md |
Workflow Decision Tree
| Need to... | Action |
|---|---|
| Set env vars / PATH / locales | Read startup-files.md → edit .zshenv or .zprofile |
| Configure aliases, keybinds, completions, prompt | Edit .zshrc |
| Fix performance issues | Read performance.md → profile startup |
| Add/configure plugins | Read plugins.md + relevant manager reference |
Chezmoi Integration
- Edit Zsh configs in the chezmoi source (this repo), not directly in
~ - Respect
{{ ... }}template blocks in files - Source naming:
dot_zshrc→~/.zshrc,private_dot_config/sheldon→~/.config/sheldon - For chezmoi workflows, see
managing-chezmoiskill
Default Guardrails
- Keep
.zshenvidempotent and fast; no external commands - No aliases/functions in
.zshenv - Use
typeset -gx VAR=...orexport VAR=...with defensive checks - Set
fpathbeforecompinit; runcompinitonce only - Document plugin load order (especially
zsh-autocomplete+zsh-syntax-highlighting)
Common Tasks
| Task | Approach |
|---|---|
| Add env var | .zshenv (everywhere) vs .zprofile (login) vs .zshrc (interactive) |
| Fix PATH | Ensure ordering, remove duplicates, avoid PATH=$PATH:... in multiple files |
| Enable completions | Set fpath → compinit once → cache if needed |
| Add plugin | Choose manager → ensure correct load order |
| Setup p10k | Instant prompt block first in .zshrc → source ~/.p10k.zsh after plugins |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mrpointer/dotfiles/configuring-zsh">View configuring-zsh on skillZs</a>