claude-code - 💡(How to fix) Fix Plugin skills discoverable but not invocable via Skill tool [1 comments, 2 participants]

TL;DR

The issue can be worked around by adding a skills table to the plugin's CLAUDE.md file that maps trigger phrases to file paths, allowing the Skill tool to invoke plugin skills.

Guidance

• Verify that the skills are defined correctly in the skills/*/SKILL.md files within the custom org plugin, with valid YAML frontmatter.
• Check that the plugin is deployed correctly via the Claude Team Plan admin and appears in the Cowork slash command menu.
• To mitigate the issue, add a skills table to the plugin's CLAUDE.md file, mapping trigger phrases to file paths, as described in the provided workaround.
• Test the workaround by invoking a plugin skill via the Skill tool after adding the skills table to the CLAUDE.md file.

Example

No code snippet is provided as it is not clearly supported by the issue, but the skills table in the CLAUDE.md file should map trigger phrases to file paths, similar to how the Read tool reads the SKILL.md file directly.

Notes

The workaround adds an unnecessary failure/retry step to every skill invocation, but it allows the Skill tool to invoke plugin skills. The root cause of the issue is that the Skill tool cannot resolve plugin skills, only anthropic-skills:* skills work via the Skill tool.

Recommendation

Apply the workaround by adding a skills table to the plugin's CLAUDE.md file, as it allows the Skill tool to invoke plugin skills, albeit with an additional step.