Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/configuring-zsh
SKILL.md
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 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?