Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] `/skills` docs omit estimated-token-count sorting and the `t` toggle [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49301•Fetched 2026-04-17 08:45:09
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×4
RAW_BUFFERClick to expand / collapse

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:

PageLine(s)Context
https://code.claude.com/docs/en/skills714-716Skill listing budget/truncation details, but no /skills sort-mode documentation
https://code.claude.com/docs/en/commands82/skills is only described as "List available skills"
https://code.claude.com/docs/en/interactive-mode101-103Explains browsing commands/skills from /, but not /skills-specific controls
https://code.claude.com/docs/en/desktop344Describes 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

extent analysis

TL;DR

Add documentation for the /skills menu sort mode and t shortcut to the relevant pages on the Claude Code website.

Guidance

Example

A possible addition to the https://code.claude.com/docs/en/skills page could be: "The /skills menu supports sorting by estimated token count. Press t to toggle the sort mode. The estimated token count represents the number of tokens required to execute a skill, and sorting by this value can help you quickly find high-cost skills or understand which skills may add more context overhead."

Notes

The suggested improvement should be implemented in a way that is consistent with the existing documentation style and tone. It may be helpful to review the changelog entry and the affected code to ensure that the documentation accurately reflects the current behavior of the /skills menu.

Recommendation

Apply the suggested improvement to update the documentation and provide clear guidance to users on how to use the /skills menu sort mode and t shortcut. This will help to reduce confusion and make the feature more discoverable.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#retrieval issue#search optimization#API routing#API middleware#SSR setup

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] `/skills` docs omit estimated-token-count sorting and the `t` toggle [1 participants]