skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mrpointer/dotfiles54 installs

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-zsh
view source ↗

Is 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

TopicReference
Startup file orderstartup-files.md
oh-my-zsh patternsoh-my-zsh.md
powerlevel10k setuppowerlevel10k.md
sheldon plugin managersheldon.md
Plugin load orderplugins.md
Performance tuningperformance.md

Workflow Decision Tree

Need to...Action
Set env vars / PATH / localesRead startup-files.md → edit .zshenv or .zprofile
Configure aliases, keybinds, completions, promptEdit .zshrc
Fix performance issuesRead performance.md → profile startup
Add/configure pluginsRead 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-chezmoi skill

Default Guardrails

  • Keep .zshenv idempotent and fast; no external commands
  • No aliases/functions in .zshenv
  • Use typeset -gx VAR=... or export VAR=... with defensive checks
  • Set fpath before compinit; run compinit once only
  • Document plugin load order (especially zsh-autocomplete + zsh-syntax-highlighting)

Common Tasks

TaskApproach
Add env var.zshenv (everywhere) vs .zprofile (login) vs .zshrc (interactive)
Fix PATHEnsure ordering, remove duplicates, avoid PATH=$PATH:... in multiple files
Enable completionsSet fpath → compinit once → cache if needed
Add pluginChoose manager → ensure correct load order
Setup p10kInstant prompt block first in .zshrc → source ~/.p10k.zsh after plugins

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>