[FEATURE] Surface usage info (descriptions, homepage link, README) in the /plugin detail view
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
After I install a plugin, I can't tell what it does or how to use it from inside Claude Code. The /plugin detail view lists only component names. For plugin-dev, for example, it shows:
Commands: create-plugin
Agents: agent-creator, plugin-validator, skill-reviewer
Skills: agent-development, command-development, hook-development, ...
— no description for any component, no link to the plugin's homepage/repo, and no way to read its README.
So after installing, my workflow is essentially "guess." The create-plugins docs tell authors to "include a README.md with installation and usage instructions," and the discover-plugins docs tell me to "visit its homepage for usage guidance" — but the TUI surfaces neither: no README, no homepage link. To actually learn how to use a plugin I have to either dig through the on-disk cache (~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/README.md) or run commands blind to see what they do, which burns tokens. Installing a plugin and being dropped at "now what?" is the problem.
Proposed Solution
Make the /plugin detail view answer "how do I use this?", not just "what's in it?". In the Installed/Discover detail pane:
- Show each component's existing
descriptionnext to its name (commands and skills already declare one in their frontmatter), instead of only the name. - Show a clickable
homepage/repositorylink from the plugin manifest. - Add a way to view or open the plugin's README from the TUI (render it in-app, or open it in the browser/editor).
(Rough mockup in Additional Context.)
Alternative Solutions
- Browsing the plugin cache on disk (
~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/README.md) — works, but requires knowing the path and leaving the tool. - Running each command/skill to see what it does — trial-and-error, and it spends tokens.
/helpandclaude plugin detailsgive names plus sometimes a one-line description, but still no README, no homepage, and no usage depth.
None of these is reachable from where I install and use the plugin.
Priority
Medium - Would be very helpful
Feature Category
Interactive mode (TUI)
Use Case Example
- I run
/pluginand installplugin-devfrom the official marketplace. - I open its detail view to figure out how to start using it.
- I see only names:
Commands: create-plugin,Agents: agent-creator, ...,Skills: agent-development, .... - I have no idea what
agent-developmentorplugin-validatordo, when they fire, or where to read more — and there's no homepage link and no README. - To learn, I leave Claude Code to find the repo, or open the README buried in
~/.claude/plugins/cache/..., or just run/plugin-dev:create-pluginblind. - With this feature, the detail view shows each component's description + a homepage link + "view README," so I know how to use the plugin immediately — no filesystem spelunking, no tokens spent just to discover behavior.
Additional Context
Related work / how this differs
- PR #15561 ("Add component metadata to plugin.json for improved discoverability") shares the motivation — "users only see name + description; no way to know... whether it fits their use case" — but proposes author-declared metadata in
plugin.json, and the TUI already derives the component list + context cost. This request is a different layer: surfacing usage (descriptions, homepage, README), not just listing components. - The detail pane is actively evolving: #60689 (pre-install component inventory) and #60402 (last-updated metadata) show it already lists components and context cost. This is the natural next step: from "what's in it" to "how to use it."
The docs already assume this should exist
- create-plugins: authors should ship a README "with installation and usage instructions."
- discover-plugins: users should "visit its homepage for usage guidance."
The TUI links to neither.
Rough mockup of the improved detail view
plugin-dev @ claude-plugins-official [ Open homepage ↗ ]
Plugin development toolkit ...
Commands
create-plugin Guided end-to-end plugin creation workflow
Agents
agent-creator Generates agent configs from a description
plugin-validator Validates plugin structure / manifest
skill-reviewer Reviews skill quality and descriptions
Skills
hook-development Guidance for creating Claude Code hooks
...
[ View README ] [ Open homepage ]
Environment
- Claude Code 2.1.152
- Windows 11
- Marketplace: claude-plugins-official
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗