[DOCS] /skills command docs missing prompt-prefill selection behavior
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/commands
Section/Topic
/skills command entry and the skill-picker workflow for inserting a selected skill into the prompt
Current Documentation
The commands reference currently says:
/skills | List available skills
The Desktop guide also says:
Select one and it appears highlighted in the input field. Type your task after it and send as usual.
But the docs do not explain that /skills opens a selectable picker and that accepting a skill pre-fills /<skill-name> in the prompt so you can continue typing arguments or task text before sending.
What's Wrong or Missing?
Changelog v2.1.119 includes this entry:
Fixed/skillsEnter key closing the dialog instead of pre-filling/<skill-name>in the prompt
That fix confirms an intended user-facing workflow: /skills is not just a passive list. Users can choose a skill from the dialog, have /<skill-name> inserted into the prompt, then add arguments or a task before submitting.
The current docs do not describe that /skills picker behavior. The commands reference reduces /skills to "List available skills," and the broader desktop guidance mentions selected skills appearing in the input field without connecting that behavior to the /skills command itself. That leaves the keyboard-driven /skills workflow undocumented.
Suggested Improvement
Expand the /skills entry in the commands reference to describe the actual interaction model, for example:
Opens the skills picker. Select a skill to insert /<skill-name> into the prompt, then add arguments or task text and send as usual.
Also add a short note in the Desktop or interactive-command docs that this same prefill flow applies when browsing skills through /skills, not only when opening slash commands from the + menu.
If Anthropic documents keyboard behavior for this picker, note that pressing Enter accepts the highlighted skill and returns you to the prompt with the skill name pre-filled.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 82 | /skills is documented only as "List available skills" |
| https://code.claude.com/docs/en/desktop | 344 | Explains that selected skills appear highlighted in the input field, but does not tie that workflow to /skills |
| https://code.claude.com/docs/en/claude-directory | 1457 | /skills is described only as showing available skills from project, user, and plugin sources |
Total scope: 3 pages affected
Source: Changelog v2.1.119
Exact changelog entry:
Fixed/skillsEnter key closing the dialog instead of pre-filling/<skill-name>in the prompt
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗