Problem
Plugin skills have a tradeoff that makes them less discoverable:
Option A - Standalone registration (e.g., /my-skill):
- Shows argument-hint/signature in autocomplete
- But the skill disappears from the namespace prefix list (
/my-plugin: no longer shows it)
Option B - No standalone registration (e.g., /my-plugin:my-skill):
- Browsable by typing
/my-plugin: to see all plugin skills
- But no argument-hint/signature is displayed
There is no way to get both behaviors simultaneously.
Expected Behavior
- Plugin skills registered as standalone should still appear under their namespace prefix (e.g.,
/my-plugin:my-skill should remain discoverable even when /my-skill exists as standalone)
- Namespace-prefixed skills (
/plugin-name:skill-name) should display the argument-hint from the skill's SKILL.md frontmatter, just like standalone skills do
Steps to Reproduce
- Create a plugin with a skill that has
argument-hint in its SKILL.md frontmatter
- Register it as a standalone skill (via marketplace.json + skills/ directory)
- Type
/skill-name - argument-hint shows correctly
- Type
/plugin-name: - the skill no longer appears in the list
- Remove standalone registration
- Type
/plugin-name: - the skill appears again, but without argument-hint
Use Case
When a user forgets a skill name but remembers which plugin it belongs to, they should be able to type /plugin-name: to browse available skills. Currently this only works if the skill is NOT registered standalone, forcing a choice between discoverability and signature display.
Environment
- Claude Code CLI on Windows 11
- Observed with both custom and first-party plugins
Problem
Plugin skills have a tradeoff that makes them less discoverable:
Option A - Standalone registration (e.g.,
/my-skill):/my-plugin:no longer shows it)Option B - No standalone registration (e.g.,
/my-plugin:my-skill):/my-plugin:to see all plugin skillsThere is no way to get both behaviors simultaneously.
Expected Behavior
/my-plugin:my-skillshould remain discoverable even when/my-skillexists as standalone)/plugin-name:skill-name) should display theargument-hintfrom the skill's SKILL.md frontmatter, just like standalone skills doSteps to Reproduce
argument-hintin its SKILL.md frontmatter/skill-name- argument-hint shows correctly/plugin-name:- the skill no longer appears in the list/plugin-name:- the skill appears again, but without argument-hintUse Case
When a user forgets a skill name but remembers which plugin it belongs to, they should be able to type
/plugin-name:to browse available skills. Currently this only works if the skill is NOT registered standalone, forcing a choice between discoverability and signature display.Environment