[DOCS] Plugin discovery docs missing CLI tool usage detection trigger for plugin tips

Open 💬 4 comments Opened Mar 19, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Plugin discovery and installation tips mechanism

Current Documentation

The only documented trigger for plugin installation suggestions is:

"If you already have a language server installed, Claude may prompt you to install the corresponding plugin when you open a project."

This describes binary-presence detection specific to LSP/code-intelligence plugins. No mention of file pattern matching or CLI tool usage detection as general triggers for plugin tips.

What's Wrong or Missing?

Changelog v2.1.80 added CLI tool usage detection to plugin tips, in addition to file pattern matching. The docs do not explain the general plugin tips system or its two trigger mechanisms:

  1. File pattern matching — tips triggered when project files match certain patterns (not documented)
  2. CLI tool usage detection — tips triggered when Claude Code detects CLI tool usage relevant to a plugin (new in v2.1.80, not documented)

Users and plugin marketplace authors have no documentation explaining how plugin tips are triggered, what patterns or signals are matched, or how CLI tool usage feeds into plugin recommendations.

Suggested Improvement

Expand the plugin discovery section to explain how plugin installation tips work:

Plugin installation tips

Claude Code suggests relevant plugins based on your project context:

  • File patterns — When your project contains files matching patterns associated with a plugin (e.g., Dockerfile, *.tf)
  • CLI tool usage — When Claude Code detects usage of CLI tools related to a plugin (e.g., running docker commands triggers Docker plugin suggestions)

This helps users discover plugins that are relevant to their current workflow.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/discover-plugins | Plugin discovery and installation tips |
| https://code.claude.com/docs/en/plugins | General plugin overview |

Total scope: 2 pages affected

Source: Changelog v2.1.80

Added CLI tool usage detection to plugin tips, in addition to file pattern matching

View original on GitHub ↗

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