AgentSkillsCN

update-completions

通过运行帮助命令，并将输出结果与当前补全脚本进行比对，更新 Claude Code CLI 的 Fish Shell 补全功能。当用户提出更新、刷新或同步补全列表的需求，亦或是新版本的 Claude Code 正式发布时，此技能便能大显身手。

SKILL.md
--- frontmatter
name: update-completions
description: >
  Update Fish shell completions for Claude Code CLI by running help commands
  and comparing output against the current completion script. Use when the user
  asks to update, refresh, or sync completions, or when a new Claude Code
  version is released.
compatibility: Requires claude CLI installed and available on PATH.
allowed-tools: Bash(claude:*) Read Write Edit

Update Fish Shell Completions for Claude Code

Overview

This skill updates completions/claude.fish to stay in sync with the latest Claude Code CLI flags, subcommands, and options.

Steps

1. Gather current CLI help output

Run each of these commands and capture the output:

bash
claude --help
claude mcp --help
claude mcp add --help
claude mcp remove --help
claude mcp add-json --help
claude mcp add-from-claude-desktop --help
claude mcp serve --help
claude mcp list --help
claude mcp get --help
claude mcp reset-project-choices --help
claude plugin --help
claude plugin validate --help
claude plugin marketplace --help
claude plugin marketplace add --help
claude plugin marketplace list --help
claude plugin marketplace remove --help
claude plugin marketplace update --help
claude plugin install --help
claude plugin uninstall --help
claude plugin enable --help
claude plugin disable --help
claude plugin update --help
claude install --help
claude update --help
claude doctor --help
claude setup-token --help

2. Compare against existing completions

Read the current completions/claude.fish file and compare it against the help output collected in step 1. Look for:

  • •New flags or options not yet in the completions file.
  • •Removed flags or options that should be deleted.
  • •Changed descriptions that should be updated.
  • •New subcommands that need completion entries.
  • •Removed subcommands that should be deleted.
  • •New or changed allowed values for flags that accept specific values (e.g., --output-format, --permission-mode, --transport).

3. Update the completions file

Edit completions/claude.fish following these patterns:

Top-level flags

fish
complete -c claude -s X -l long-name -d "Description from help"
# For flags with specific allowed values:
complete -c claude -l flag-name -xa "val1 val2 val3" -d "Description"

Subcommands

fish
complete -c claude -n __fish_use_subcommand -xa "subcommand" -d "Description"

Nested subcommands

fish
complete -c claude -n "__fish_seen_subcommand_from parent" -xa "child" -d "Description"

Subcommand-specific flags

fish
complete -c claude -n "__fish_seen_subcommand_from subcmd" -l flag -d "Description"

Dynamic completions (helper functions)

The file contains __claude_* helper functions that call claude CLI with --json at tab-completion time. These provide live argument suggestions for plugin and marketplace subcommands. When updating:

  • •

    Do not remove or rename the helper functions unless the underlying CLI commands change.

  • •

    If a new subcommand accepts a plugin or marketplace name as a positional argument, add a dynamic completion line using the appropriate helper function (e.g., -xa "(__claude_installed_plugins)").

  • •

    Helper functions parse JSON using string match -r / string replace — no jq dependency.

  • •

    Keep complete -c claude -f as the first line (disables file completions).

  • •

    Group related completions together with comments.

  • •

    Use -xa for exclusive completion values.

  • •

    Use -s for short flags and -l for long flags.

  • •

    Descriptions (-d) should match the CLI help text.

4. Test the changes

fish
source completions/claude.fish
complete -C "claude "
complete -C "claude mcp "
complete -C "claude --output-format "
complete -C "claude plugin install "
complete -C "claude plugin marketplace remove "

Verify that new completions appear, dynamic completions return expected values, and no errors are raised.

5. Summarize changes

List what was added, removed, or updated so the user can review before committing.