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

•

開発者ツール

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

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.

主な機能

01Standardized ZSH completion file generation following the <topic>/completion.zsh pattern

02Implementation of multi-level subcommand hierarchies and state-based argument parsing

03Pattern-based option registration using _arguments and _describe functions

04Integration with built-in ZSH completers for files, directories, and predefined values

05Troubleshooting guides for common shell completion errors and loading issues

066 GitHub stars

ユースケース

01Generating custom tab-completion for an internal team CLI tool

02Fixing broken autocomplete behavior in existing dotfiles scripts

03Adding intelligent flag and option suggestions to shell aliases or functions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bendrucker/dotfiles completions

For use in Claude.ai and ChatGPT

Download Skill