Help dialog truncates custom commands; built-in skill renders in Custom Commands tab

Resolved 💬 2 comments Opened Feb 21, 2026 by lokkaflokka Closed Mar 21, 2026

Description

Two related issues with the /help dialog's "Custom Commands" tab:

1. Command list silently truncated

With 12 custom command files in .claude/commands/, only the first ~11 are displayed. The last 3 alphabetically (/sync-review, /synthesize, /weekly) are silently dropped — no scroll, no pagination, no "N more..." indicator.

All 12 commands do load into the system prompt and work when invoked directly. This is display-only.

Likely cause: The display appears tied to the skill character budget (2% of context window / ~16,000 chars). My 12 command files total ~60KB — well over the budget. The last few alphabetically get excluded from the help rendering even though they're functional.

2. Built-in claude-developer-platform renders in Custom Commands tab

The claude-developer-platform skill appears to be bundled into the Claude Code binary (no file on disk — checked ~/.claude/commands/, ~/.claude/skills/, plugins directory, and the install path). However, it renders in the "Custom Commands" tab alongside project commands rather than as "(bundled)" like /debug.

Its full multi-line trigger description (~700+ chars) displays inline, consuming significant vertical space and budget while project commands only show (project) with no description text.

3. Project command descriptions not shown

Project commands display only their name and (project) label. The description text (first paragraph of the .md file) is loaded into the system prompt but not rendered in the help dialog. Showing even a one-line description would make the help dialog more useful for discovery.

Steps to Reproduce

  1. Create 12+ custom command files in .claude/commands/, each with a description on line 3
  2. Open /help → "Custom Commands" tab
  3. Observe: list truncated, claude-developer-platform shown as custom, no descriptions for project commands

Expected Behavior

  • All custom commands visible (scrollable/paginated, or with overflow indicator)
  • Built-in skills labeled distinctly from user-created commands
  • Project command descriptions shown in the help dialog

Environment

  • macOS (Apple Silicon), Claude Code v2.1.49–2.1.50
  • 12 project-level command files in .claude/commands/
  • 1 plugin installed (swift-lsp)

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗