[DOCS] Documentation Consistency: "SlashCommand" vs "Skill" Tool Naming Artifacts

Documentation Type

Unclear/confusing documentation

Documentation Location

docs/en/settings.md and docs/en/slash-commands.md

Section/Topic

• docs/en/settings.md: Environment variables section (SLASH_COMMAND_TOOL_CHAR_BUDGET) - docs/en/slash-commands.md: "Skill tool" section

Current Documentation

In docs/en/slash-commands.md:

"In earlier versions of Claude Code, slash command invocation was provided by a separate SlashCommand tool. This has been merged into the Skill tool."

In docs/en/settings.md:

SLASH_COMMAND_TOOL_CHAR_BUDGET | Maximum number of characters for slash command metadata shown to the Skill tool (default: 15000)

What's Wrong or Missing?

A comprehensive scan of the documentation (IAM, SDK, Configuration) confirms that the SlashCommand tool has been largely scrubbed and replaced by Skill. However, a naming inconsistency remains in the environment variables.

While docs/en/settings.md correctly describes SLASH_COMMAND_TOOL_CHAR_BUDGET as affecting the "Skill tool," the variable name itself relies on the legacy "SlashCommand" terminology. This creates a cognitive dissonance where the configuration key (SLASH_COMMAND...) does not match the feature name (Skill tool) described in the adjacent text.

Suggested Improvement

In docs/en/settings.md, explicitly note that SLASH_COMMAND_TOOL_CHAR_BUDGET is a legacy name maintained for backward compatibility, but it controls the Skill tool's context budget.

Suggested Text:

SLASH_COMMAND_TOOL_CHAR_BUDGET | (Legacy Name) Maximum number of characters for slash command and skill metadata shown to the Skill tool (default: 15000).

Impact

High - Prevents users from using a feature

Additional Context

I performed a full scan of the documentation set to ensure no other legacy references exist.

Scan Findings:

• docs/en/agent-sdk/*: CLEAN. No references to SlashCommand as a tool in permission lists or configurations. (Note: type SlashCommand exists in TypeScript definitions, but refers to the command metadata object, which is semantically correct).
• docs/en/iam.md: CLEAN. Permission examples use Skill, Bash, WebFetch, etc.
• docs/en/settings.md: INCONSISTENT. Contains SLASH_COMMAND_TOOL_CHAR_BUDGET variable pointing to Skill tool functionality.
• docs/en/slash-commands.md: ACCURATE. Correctly documents the merge of SlashCommand into Skill.
• CHANGELOG.md: ACCURATE. v2.1.3 confirms "Merged slash commands and skills".