fix(skills): reject multi-skill Claude plugin archives

Document the portable SKILL.md compatibility boundary for Claude Code plugin bundles and keep /skill install from silently flattening plugin archives that carry multiple skills plus plugin.json runtime metadata.

Reported by @AiurArtanis in #2743.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Hunter B
2026-06-13 08:20:36 -07:00
parent 38ce04790a
commit 877b44935e
5 changed files with 115 additions and 3 deletions
+3 -2
View File
@@ -404,8 +404,9 @@ work. Read the local guidance before editing, and keep any contribution within
the repository's conventions.
Next: see [SKILL_INVOCATION_DESIGN.md](SKILL_INVOCATION_DESIGN.md) for skill
activation behavior and [CONFIGURATION.md](CONFIGURATION.md) for config paths
and project authority.
activation behavior, [CLAUDE_PLUGIN_COMPAT.md](CLAUDE_PLUGIN_COMPAT.md) for
Claude Code skill/plugin compatibility, and [CONFIGURATION.md](CONFIGURATION.md)
for config paths and project authority.
## 10. Getting Help