zsh-shell-config

What problem does it solve?

This Skill prevents broken or inconsistent Zsh startup behavior by enforcing Zsh-native configuration patterns for PATH management, completion initialization, framework coexistence, and reliable tool integration.

Core Features & Use Cases

• Correct startup-file placement: Routes environment variables to .zshenv, login-time setup to .zprofile, and interactive behaviors (aliases/functions/completions) to .zshrc.
• PATH and completion correctness: Uses typeset -U path, extends fpath before compinit, and applies a ~/.zcompdump age guard to avoid slow shell startups.
• Framework-aware integration: Detects common frameworks (oh-my-zsh, prezto, zinit, antigen, p10k/powerlevel10k) and places configuration where each framework expects it.
• Tool integration templates: Adds guarded init patterns for common tools (Go, Rust, Node via fnm, Python via pyenv, direnv, fzf, zoxide, mise, starship, Homebrew shellenv).
• Hook-safe customization: Uses add-zsh-hook instead of overwriting precmd/preexec, reducing silent breakage and prompt issues.
• Verification and failure-mode guidance: Includes diagnostics for syntax errors, missing PATH in scripts, slow startup, insecure completion directories, and completion-cache issues.

Quick Start

Configure your Zsh environment for PATH and completions by asking an AI to set up ~/.zshenv and ~/.zshrc following this skill’s rules, then validate loading order and startup performance.