[DOCS] Skill metadata budget docs still claim fixed 15,000-char default after v2.1.32 scaling change

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Skill metadata character budget behavior and SLASH_COMMAND_TOOL_CHAR_BUDGET defaults.

Current Documentation

Current docs state a fixed default budget:

"...they may exceed the character budget (default 15,000 characters)."

Settings docs also state:

"SLASH_COMMAND_TOOL_CHAR_BUDGET ... (default: 15000)."

What's Wrong or Missing?

Claude Code changelog v2.1.32 says:

Skill character budget now scales with context window (2% of context), so users with larger context windows can see more skill descriptions without truncation

The docs still describe a fixed 15,000-character default, which is now outdated and can mislead users when diagnosing truncated skill lists.

Suggested Improvement

Update both skills and settings docs to reflect current behavior:

1. Replace fixed default wording with dynamic default formula (2% of context window).
2. Clarify how SLASH_COMMAND_TOOL_CHAR_BUDGET interacts with the dynamic default (override semantics).
3. Add one example showing why larger context windows produce larger skill metadata budgets.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/skills | 659-661 | States fixed default 15,000-character skill metadata budget |
| https://code.claude.com/docs/en/settings | 822 | SLASH_COMMAND_TOOL_CHAR_BUDGET row still states default 15000 |

Total scope: 2 pages affected

Source: Claude Code changelog v2.1.32

Skill character budget now scales with context window (2% of context), so users with larger context windows can see more skill descriptions without truncation