shell-completer

Generate shell completion scripts for bash, zsh, and fish shells.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/winsorllc/upgraded-carnival --skill shell-completer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shell-completer
Source: https://github.com/winsorllc/upgraded-carnival/tree/main/.pi/skills/shell-completer
Command: npx skills add https://github.com/winsorllc/upgraded-carnival --skill shell-completer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of shell completion scripts for command-line interface (CLI) tools, enhancing user experience and productivity by providing context-aware suggestions.

Core Features & Use Cases

  • Generate Completions: Create completion scripts for bash, zsh, and fish shells.
  • Package Integration: Generate completions directly from package.json scripts.
  • Auto-Detection: Automatically detect the current shell for seamless integration.
  • Use Case: You've just built a new CLI tool and want to make it easier for users to interact with it. This Skill can generate the necessary completion scripts so users can tab-complete commands and arguments.

Quick Start

Use the shell-completer skill to generate bash completion scripts for the 'my-cli-tool' command.

Frequently Asked Questions about shell-completer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate shell completion scripts for a CLI tool?

Shell completion scripts for CLI tools are generated by providing the command arguments to produce context-aware suggestions. This process supports bash, zsh, and fish shells, enabling tab-completion for commands and arguments.

Can I generate bash and zsh completion scripts from package.json?

Yes, completion scripts can be generated directly from package.json scripts. This package integration automates the setup process for bash, zsh, and fish shells, facilitating efficient command-line interaction.

How does auto-detection work for shell completion setup?

Shell completion auto-detection works by automatically identifying the current shell environment. This enables seamless integration and auto-installation of the appropriate context-aware completion scripts without manual configuration.

What is the best way to add tab-completion to a custom CLI tool?

The best way to add tab-completion to a custom CLI tool is to generate completion scripts from its command arguments. This provides context-aware suggestions to users, enhancing interaction across bash, zsh, and fish shells.

Does shell completion generation work with fish shell?

Yes, shell completion generation explicitly works with fish shell, alongside bash and zsh. It creates the necessary scripts to provide tab-completion and context-aware suggestions for your CLI commands.

Why do I need shell completion scripts for my command-line interface?

You need shell completion scripts to automate context-aware suggestions and tab-completion for your command-line interface. This enhances user experience and productivity by making it easier to interact with your CLI tool.