how-plugins-work

Claude Code plugin naming uses a three-name model: Plugin name, Skill name, and Marketplace name. The system combines these namespaces differently depending on the context to resolve slash commands and populate autocomplete suggestions.

Unknown command errors occur when Claude Code cannot resolve a slash command due to name collisions or incorrect invocation syntax. Using the proper namespaced invocation pattern instead of a bare slash command disambiguates the target skill and fixes the resolution failure.

Use bare slash commands for simple, single-context scenarios, and switch to namespaced invocations when debugging name collisions across multiple plugins or bundles. Namespacing prevents conflicts by explicitly routing the command to the correct plugin and skill.

Broken autocomplete stems from improper skill naming conventions and unresolved namespace collisions. Clarifying the three-name model and ensuring the plugin, skill, and marketplace names follow resolution rules restores correct autocomplete behavior.

Plugin name collisions are avoided by understanding the separate namespaces for Plugin, Skill, and Marketplace names. Documenting how these names combine and applying the correct resolution patterns prevents invocation conflicts across installed bundles.