claude-code - 💡(How to fix) Fix [DOCS] `/plugin` Discover tab docs omit directory-based suggested plugin pins

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/discover-plugins

Section/Topic

/plugin Discover tab browsing and plugin recommendation behavior

Current Documentation

The Discover plugins page currently says:

The official Anthropic marketplace (claude-plugins-official) is automatically available when you start Claude Code. Run /plugin and go to the Discover tab to browse what's available, or view the catalog at claude.com/plugins.

Later, the demo marketplace walkthrough describes the /plugin interface:

Run /plugin to open the plugin manager. This opens a tabbed interface with four tabs you can cycle through using Tab (or Shift+Tab to go backward):

• Discover: browse available plugins from all your marketplaces
• Installed: view and manage your installed plugins
• Marketplaces: add, remove, or update your added marketplaces
• Errors: view any plugin loading errors

The same page also documents one suggestion trigger for code intelligence plugins:

These plugins require the language server binary to be installed on your system. If you already have a language server installed, Claude may prompt you to install the corresponding plugin when you open a project.

What's Wrong or Missing?

Claude Code v2.1.154 changed the /plugin Discover tab so plugins whose relevance signals match the current directory are pinned and annotated as "suggested for this directory".

The current docs explain that the Discover tab lets users browse plugins, and they mention one prompt flow for language-server plugins, but they do not document the new Discover tab behavior:

A. Directory-matched plugin pins are not described

Users are not told that plugins can be pinned in the Discover tab when their relevance signals match the current directory.

B. The annotation text is not explained

The phrase "suggested for this directory" can appear in the UI, but the docs do not explain what it means, what directory is considered current, or that it is based on relevance signals.

C. The relationship to plugin recommendations is unclear

The page has separate fragments about browsing marketplaces and possible install prompts, but no short description of how directory context can affect the Discover tab ordering itself.

Suggested Improvement

Add a short note to the Discover tab section explaining directory-based suggestions.

Suggested wording:

In the Discover tab, Claude Code may pin plugins that look relevant to your current directory. These plugins are marked "suggested for this directory" when their relevance signals match files, tools, or other project context in the directory where Claude Code is running. Suggestions help surface likely-useful plugins, but Claude Code still asks before installing anything.

If relevance signals are intentionally limited to specific signal types, list those types or link to the plugin recommendation mechanism that defines them.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Version context: Claude Code v2.1.154 added /plugin Discover tab pins for plugins whose relevance signals match the current directory, with a "suggested for this directory" annotation.

Total scope: 1 documentation page affected.