Should I use this for Homebrew-installed packages?

No, Homebrew typically handles completion installation automatically. This skill is intended for custom scripts or tools that lack native completion support.

Why does this skill use compdef instead of the #compdef directive?

This skill follows a specific dotfiles pattern where completion files are sourced directly rather than being added to fpath, which requires explicit compdef calls for registration.

Can this skill help with complex commands like git or docker?

Yes, it includes specific patterns for nested subcommands and state-based argument handling for deep command hierarchies.

What common ZSH functions are used in these completions?

The skill utilizes standard ZSH internals including _files for paths, _describe for command lists, and _arguments for robust flag parsing.

How do I verify that a new completion script is working?

Reload your shell by running 'source ~/.zshrc', then type the command followed by the Tab key to see if the options and subcommands appear correctly.

ZSH Shell Completions

Name: ZSH Shell Completions
Author: bendrucker

bybendrucker

•

Developer Tools

Manages and implements custom ZSH completion scripts to provide intelligent tab-autocomplete for command-line tools.

About

This skill provides standardized patterns and conventions for developing custom ZSH autocomplete functionality within a dotfiles environment. It enables Claude to create, update, and debug completion files—typically organized as topic-specific scripts—ensuring they are properly registered using the compdef function. It is ideal for developers looking to add tab-completion to internal scripts, custom CLI tools, or third-party binaries that do not provide native shell integration, following the specific loading conventions of the zshrc environment.

Key Features

Standardized ZSH completion file generation following the <topic>/completion.zsh pattern
Implementation of multi-level subcommand hierarchies and state-based argument parsing
Pattern-based option registration using _arguments and _describe functions
Integration with built-in ZSH completers for files, directories, and predefined values
Troubleshooting guides for common shell completion errors and loading issues
6 GitHub stars

Use Cases

Generating custom tab-completion for an internal team CLI tool
Fixing broken autocomplete behavior in existing dotfiles scripts
Adding intelligent flag and option suggestions to shell aliases or functions

About

Key Features

Standardized ZSH completion file generation following the <topic>/completion.zsh pattern
Implementation of multi-level subcommand hierarchies and state-based argument parsing
Pattern-based option registration using _arguments and _describe functions
Integration with built-in ZSH completers for files, directories, and predefined values
Troubleshooting guides for common shell completion errors and loading issues
6 GitHub stars

Use Cases

Generating custom tab-completion for an internal team CLI tool
Fixing broken autocomplete behavior in existing dotfiles scripts
Adding intelligent flag and option suggestions to shell aliases or functions