claude-code - 💡(How to fix) Fix [DOCS] Slash command docs omit mid-input autocomplete behavior

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

Slash command discovery and autocomplete behavior in interactive input

Current Documentation

The docs currently say:

Type / to see every command available to you, or type / followed by letters to filter.

A command is only recognized at the start of your message. Text that follows the command name is passed to it as arguments.

The interactive mode page also says:

| / at start | Command or skill | See commands and skills |

What's Wrong or Missing?

These pages currently frame slash commands as a start-of-message interaction and do not explain the current autocomplete behavior when / is typed later in the input.

That wording conflates two different things:

A. Command execution

/command execution still needs clear start-of-message rules.

B. Command autocomplete and discovery

The docs do not say that the slash-command autocomplete UI can appear when / is typed mid-input, so users reading the reference can reasonably conclude that later-in-prompt slash autocomplete is unsupported or broken.

Suggested Improvement

Add a short clarification to the commands and interactive mode docs that separates command execution from autocomplete behavior.

Before:

A command is only recognized at the start of your message.

After:

Claude executes a slash command only when it starts the message, but the slash-command autocomplete menu can appear anywhere in the input when you type /, so you can discover or insert a command while editing a longer prompt.

Also update the interactive mode quick-commands table so the / row does not imply that slash-related discovery only works at prompt start.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Cross-reference:

Total scope: 2 primary docs pages affected

Version context: This gap is relevant to the v2.1.136 slash-command autocomplete change under review because the reference pages still present slash discovery as start-of-message only.