claude-code - 💡(How to fix) Fix Plugins in claude-plugins-official marketplace lack `version` field in plugin.json, displayed as "unknown"

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Several plugins distributed through the official claude-plugins-official marketplace do not declare a version in their .claude-plugin/plugin.json (and have no version pinned in the marketplace entry either). As a result, claude plugin list shows them with Version: unknown, and they install into a cache directory named unknown/ rather than a versioned slot.

This is a metadata hygiene issue, not a runtime bug — the plugins load and function correctly. But for an official Anthropic-maintained marketplace it surfaces inconsistency in user-facing output and prevents straightforward version tracking, changelog correlation, and rollback.

Root Cause

Low-Medium — Affects user clarity, version tracking, and changelog correlation. Does not break plugin functionality. Notable because it affects the official Anthropic-maintained marketplace specifically.

RAW_BUFFERClick to expand / collapse

Summary

Several plugins distributed through the official claude-plugins-official marketplace do not declare a version in their .claude-plugin/plugin.json (and have no version pinned in the marketplace entry either). As a result, claude plugin list shows them with Version: unknown, and they install into a cache directory named unknown/ rather than a versioned slot.

This is a metadata hygiene issue, not a runtime bug — the plugins load and function correctly. But for an official Anthropic-maintained marketplace it surfaces inconsistency in user-facing output and prevents straightforward version tracking, changelog correlation, and rollback.

Observed State (claude-plugins-official, as of 2026-05-08)

Audited `~/.claude/plugins/cache/claude-plugins-official/<name>/<version>/.claude-plugin/plugin.json`:

Pluginplugin.json `version`marketplace.json `version`Display
claude-code-setup`1.0.0`absent`1.0.0` ✓
claude-md-management`1.0.0`absent`1.0.0` ✓
ralph-loop`1.0.0`absent`1.0.0` ✓
superpowers`5.1.0`absent`5.1.0` ✓
vercel`0.42.1`absent`0.42.1` ✓
code-reviewMISSINGabsent`unknown` ✗
feature-devMISSINGabsent`unknown` ✗
frontend-designMISSINGabsent`unknown` ✗
playwrightMISSINGabsent`unknown` ✗
pr-review-toolkitMISSINGabsent`unknown` ✗
security-guidanceMISSINGabsent`unknown` ✗
skill-creatorMISSINGabsent`unknown` ✗
session-report(no plugin.json)absent`unknown` ✗
swift-lsp(no plugin.json)`1.0.0``1.0.0` (via mp) ✓

Summary: 8 of 14 plugins display as `Version: unknown`. 7 of those have a `plugin.json` but no `version` key. 1 (`session-report`) has no `plugin.json` at all.

Reproduction

```bash claude plugin list

observe several @claude-plugins-official entries with Version: unknown

ls ~/.claude/plugins/cache/claude-plugins-official/code-review/

→ "unknown"

jq '.version' ~/.claude/plugins/cache/claude-plugins-official/code-review/unknown/.claude-plugin/plugin.json

→ null

```

Expected Behavior

Plugins distributed through Anthropic's own official marketplace should populate either:

  • `version` in their `plugin.json`, or
  • `version` in the marketplace entry (as `swift-lsp` already does)

…so users see a meaningful version string and can correlate against release notes / changelog.

Why an issue rather than a PR

The affected plugins live in `anthropics/claude-plugins-official/plugins/`, so adding `"version": "..."` to each `plugin.json` is mechanically a one-line change. However, the value of that version is a maintainer policy decision (initial version number, semver scheme, future bump conventions) that an external contributor can't make unilaterally. The repository also has no existing tags or releases to derive versions from. Hence this issue rather than a drive-by PR.

Suggested Fix

Add a `version` field to each plugin's `.claude-plugin/plugin.json` (or to the corresponding entry in the marketplace `marketplace.json`). For the plugin with no `plugin.json` at all (`session-report`), create one.

Impact

Low-Medium — Affects user clarity, version tracking, and changelog correlation. Does not break plugin functionality. Notable because it affects the official Anthropic-maintained marketplace specifically.

Environment

  • Claude Code CLI 2.1.132
  • macOS (Darwin 25.4.0)
  • Marketplace: `claude-plugins-official` (anthropics/claude-plugins-official)

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING