[DOCS] Plugins reference missing `claude plugin tag` release-tag command

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

CLI commands reference and Distribution and versioning reference for plugin development

Current Documentation

The docs currently describe plugin management and versioning, but not the new release-tagging command.

From the CLI reference:

claude plugin | Manage Claude Code plugins. Alias: claude plugins. See plugin reference for subcommands

From the plugin reference:

Claude Code provides CLI commands for non-interactive plugin management, useful for scripting and automation. ### plugin install ### plugin uninstall ### plugin enable ### plugin disable ### plugin update

From the versioning guidance:

* Update the version in plugin.json before distributing changes

There is no documentation for claude plugin tag, creating release git tags for plugins, or the command's version-validation behavior.

What's Wrong or Missing?

Changelog v2.1.118 added claude plugin tag to create release git tags for plugins with version validation, but the Claude Code docs do not explain that this command exists.

That leaves the plugin release workflow incomplete: plugin authors can see install/update/versioning guidance, but not the CLI command for creating a release tag, what version source it validates, what tag it creates, or what errors users should expect when the plugin version is invalid.

Suggested Improvement

Add a ### plugin tag subsection to https://code.claude.com/docs/en/plugins-reference that documents:

• command purpose and release workflow context
• command syntax, arguments, and options
• what version is validated (plugin.json, marketplace metadata, or both)
• expected git tag naming/output behavior
• failure cases when version validation does not pass
• at least one example for tagging a normal release and one for a prerelease if supported

Also add a short cross-reference from https://code.claude.com/docs/en/plugins in the plugin-sharing/versioning guidance so plugin authors can discover the documented release flow.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugins-reference | Plugin CLI subcommands and semantic-version guidance |
| https://code.claude.com/docs/en/cli-reference | Top-level claude plugin command entry should point readers to the new subcommand |
| https://code.claude.com/docs/en/plugins | Plugin sharing/versioning workflow for developers |
| https://code.claude.com/docs/en/plugin-marketplaces | Release-channel and version-resolution guidance may need a cross-reference to release tagging |

Total scope: 4 pages affected

Source: Changelog v2.1.118

Exact changelog entry:

Added claude plugin tag to create release git tags for plugins with version validation