[DOCS] `/skills` docs omit estimated-token-count sorting and the `t` toggle

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Browsing skills and /skills menu behavior

Current Documentation

The docs currently cover how to browse and invoke skills, but they do not document the new /skills sort mode or its keyboard shortcut.

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

/skills | List available skills

From https://code.claude.com/docs/en/interactive-mode:

Type / in Claude Code to see all available commands, or type / followed by any letters to filter. The / menu shows everything you can invoke: built-in commands, bundled and user-authored skills, and commands contributed by plugins and MCP servers.

From https://code.claude.com/docs/en/skills:

Skill descriptions are loaded into context so Claude knows what's available. All skill names are always included, but if you have many skills, descriptions are shortened to fit the character budget, which can strip the keywords Claude needs to match your request. The budget scales dynamically at 1% of the context window, with a fallback of 8,000 characters.

None of these pages mention sorting the /skills menu by estimated token count or pressing t to toggle the sort mode.

What's Wrong or Missing?

Changelog v2.1.111 added a user-facing /skills menu capability: /skills menu now supports sorting by estimated token count — press t to toggle.

The current docs mention that /skills exists and explain skill listing/description budget behavior, but they do not explain:

• that the /skills menu has multiple sort modes
• that estimated token count is one of the available sort orders
• that t toggles the sort mode while browsing the menu

That leaves users with no discoverable documentation for a new interaction that is especially useful when they want to find high-cost skills quickly or understand which skills may add more context overhead.

Suggested Improvement

Add a short subsection to https://code.claude.com/docs/en/skills describing /skills menu controls.

Suggested content outline:

1. Explain that /skills opens the available-skills list.
2. Document the supported sort modes, including estimated token count.
3. Document the t shortcut to toggle the sort mode.
4. Briefly explain what the estimated token count represents so users know how to interpret the ordering.

It would also help to add a brief note or cross-reference from https://code.claude.com/docs/en/commands where /skills is currently only described as "List available skills."

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/skills | 714-716 | Skill listing budget/truncation details, but no /skills sort-mode documentation |
| https://code.claude.com/docs/en/commands | 82 | /skills is only described as "List available skills" |
| https://code.claude.com/docs/en/interactive-mode | 101-103 | Explains browsing commands/skills from /, but not /skills-specific controls |
| https://code.claude.com/docs/en/desktop | 344 | Describes browsing slash commands and skills in the UI, but not sorting or t |

Total scope: 4 pages affected

Source: Changelog v2.1.111

Exact changelog entry: /skills menu now supports sorting by estimated token count — press t to toggle