[DOCS] Plugin install docs do not explain reinstall behavior for already-installed plugins or dependency repair

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

plugin install command reference, plus the install/troubleshooting guidance for reinstalling plugins

Current Documentation

The command reference currently says:

Install a plugin from available marketplaces. claude plugin install <plugin> [options] Scope determines which settings file the installed plugin is added to.

The install guide currently says:

Once you've added marketplaces, you can install plugins directly (installs to user scope by default): /plugin install plugin-name@marketplace-name

The troubleshooting section also says:

Plugin skills not appearing: Clear the cache with rm -rf ~/.claude/plugins/cache, restart Claude Code, and reinstall the plugin.

What's Wrong or Missing?

Changelog v2.1.118 includes: Fixed plugin install on an already-installed plugin not re-resolving a dependency installed at the wrong version.

The docs do not explain that rerunning /plugin install or claude plugin install against an already-installed plugin is a supported repair path, or that plugin install re-resolves plugin dependencies when the installed dependency version is wrong.

That leaves a gap between the troubleshooting advice to "reinstall the plugin" and the actual supported command behavior. A user reading the current docs cannot tell whether they should uninstall first, rerun install directly, or expect install to repair dependency mismatches.

Suggested Improvement

Add a short note under the plugin install command docs and the plugin troubleshooting guidance that explains:

• rerunning plugin install on an already-installed plugin is supported
• the command refreshes dependency resolution for plugin-declared dependencies
• this is an appropriate recovery step when a plugin install is present but broken because a dependency was installed at the wrong version

An example note would be enough; this does not need a long workflow.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugins-reference | Primary plugin install command semantics |
| https://code.claude.com/docs/en/discover-plugins | User-facing install flow and troubleshooting guidance |
| https://code.claude.com/docs/en/cli-reference | Entry point that sends users to plugin command docs |

Total scope: 3 pages affected

Source: Changelog v2.1.118

Exact changelog entry:

Fixed plugin install on an already-installed plugin not re-resolving a dependency installed at the wrong version