[BUG] Plugin skill references resolved against local .claude/skills/ instead of plugin cache
Bug Report
Claude Code Version: 2.1.49
OS: macOS (Darwin, Apple Silicon M4 Max)
Platform: macOS
Summary
When a plugin command references a skill using the namespace prefix (e.g., coding-workflows:issue-workflow), Claude Code searches the local project .claude/skills/ directory instead of the plugin cache at ~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/skills/.
This causes "skill not found" warnings even though the skill exists in the correctly installed plugin.
Steps to Reproduce
- Install a plugin from a custom marketplace (e.g.,
coding-workflows@ai-coding-resources) - Plugin is cached at
~/.claude/plugins/cache/ai-coding-resources/coding-workflows/1.1.3/ - Plugin contains skills like
skills/issue-workflow/SKILL.md - Run a command that references the skill: e.g.,
/coding-workflows:prepare-issue 1 - The command internally says: "Read the
coding-workflows:issue-workflowskill"
Expected Behavior
Claude Code resolves coding-workflows:issue-workflow to the plugin cache path:~/.claude/plugins/cache/ai-coding-resources/coding-workflows/1.1.3/skills/issue-workflow/SKILL.md
Actual Behavior
Claude Code globs .claude/skills/**/issue-workflow* (the local project skills directory), finds nothing, and reports:
Note: coding-workflows:issue-workflow skill not found — proceeding without it.
The skill exists at the correct plugin cache location and works fine when loaded via --plugin-dir (local path), but the marketplace-installed version fails to resolve skill references within its own commands.
Diagnosis
The namespace prefix coding-workflows: should tell Claude Code to look in the plugin directory, not locally. When loaded via --plugin-dir /path/to/plugins/coding-workflows, skills resolve correctly because they are at a known local path. When loaded via marketplace (enabledPlugins in settings.json), the skill resolution does not follow the namespace to the plugin cache.
Workaround
Use --plugin-dir pointing to the local plugin directory instead of marketplace installation. This correctly resolves all skill references.
Related Issues
- #24859 (Windows Cowork plugin skills wrong path — similar family, different platform)
- #11278 (marketplace.json path resolution — similar root cause area)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗