zsh-shell-config
Installation
SKILL.md
Zsh Shell Configuration Skill
Zsh is POSIX-compatible with powerful extensions. Every pattern here targets Zsh 5.8+ (ships with macOS 14+, Ubuntu 22.04+). All generated code must use Zsh-native syntax — typeset/local for scoping, path array for PATH, compinit for completions.
Reference Loading Table
| Signal | Load These Files | Why |
|---|---|---|
| migrations, bash syntax, POSIX shell | bash-migration.md |
Bash→Zsh syntax translation table with code blocks for each pattern |
| parameter expansion, scoping, special vars, fpath | zsh-quick-reference.md |
Variable flags, expansion flags ${(f)} ${(s)} ${(j)}, special variables |
| implementation patterns, failure modes, detection commands | zsh-preferred-patterns.md |
Pattern catalog with grep detection and error-fix mappings |
| Go, Rust, Node, Python, starship, direnv, fzf, zoxide, mise | tool-integrations.md |
Concrete zsh integration patterns for common dev tools |
Step 1: Confirm Zsh Context
Before writing any shell code, confirm the target is Zsh: