Agent skill
zinit-zsh
Zinit zsh plugin manager configuration and binary installs. This skill should be used when adding zsh plugins, installing CLI tools via gh-r releases, configuring completions, managing turbo/wait loading, using ice modifiers (sbin, atclone, atpull, as, from), troubleshooting plugin load order, working with OMZ snippets, or modifying .zshrc and ~/.config/zsh/ files in this stow-managed dotfiles repo.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/zinit-zsh
SKILL.md
Zinit ZSH Plugin Manager
Manage zsh plugins, CLI binary installs, and completions using zinit in this dotfiles repo.
Repo Structure
This repo uses GNU Stow. Files symlink to $HOME:
.zshrc- main zinit config, plugin definitions, binary installs.config/zsh/- modular zsh configs loaded viazinit snippetplugins.zsh- additional plugin loadsaliases.zsh- shell aliasesexports.zsh- PATH and env varscompletions.zsh- completion setupcompletions/- custom completion files (_just, _inv, etc.)history.zsh,keys.zsh,styles.zsh- other configs
Quick Reference
Binary Install Pattern (gh-r)
zinit as"null" wait lucid from"gh-r" for \
sbin"binary-name" owner/repo
With Completion Generation
zinit for \
from'gh-r' \
sbin'tool' \
atclone'./tool completion zsh > _tool' atpull'%atclone' as'completion' \
@owner/repo
OMZ Plugin/Snippet
zinit wait lucid for \
OMZP::plugin-name \
OMZL::lib-file.zsh
Build from Source
zinit for \
as'null' \
configure'--prefix=$PWD' \
make'install' \
sbin \
@owner/repo
Key Ice Modifiers
| Ice | Purpose |
|---|---|
from'gh-r' |
Download from GitHub releases |
sbin'pattern -> name' |
Create bin symlink in $ZPFX/bin |
wait"N" |
Turbo load after N seconds |
lucid |
Suppress "Loaded..." message |
atclone"cmd" |
Run on clone |
atpull'%atclone' |
Run atclone on update |
as'completion' |
Register as completion |
as'null' |
Don't source as plugin |
Detailed References
For comprehensive patterns and troubleshooting, see:
references/ice-modifiers.md- all ice options with examplesreferences/patterns.md- common install patternsreferences/troubleshooting.md- load order, debugging
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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.
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.
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.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
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?