Files
hmbown--codewhale/docs/CLAUDE_PLUGIN_COMPAT.md
wehub-resource-sync d68f003000
CI / Change detection (push) Has been cancelled
CI / Version drift (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Workflow RLM cache (push) Has been cancelled
CI / Test (macos-latest) (push) Has been cancelled
CI / Test (ubuntu-latest) (push) Has been cancelled
CI / Test (windows-latest) (push) Has been cancelled
CI / npm wrapper smoke (push) Has been cancelled
CI / Mobile runtime smoke (push) Has been cancelled
CI / Workflow lint (push) Has been cancelled
CI / Documentation (push) Has been cancelled
Web Frontend / Lint & Type Check (push) Failing after 1s
Auto-close harvested PRs / close (push) Failing after 1s
cargo-deny / cargo-deny (bans licenses sources) (push) Failing after 1s
Security audit / cargo-audit (push) Failing after 1s
Sync to CNB / sync (push) Failing after 1s
cargo-deny / cargo-deny (advisories) (push) Failing after 3s
Web Frontend / Deploy to Cloudflare (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:08:23 +08:00

36 lines
1.5 KiB
Markdown

# Claude Plugin Compatibility
CodeWhale treats Claude Code skill folders as instruction bundles when they are
plain `SKILL.md` directories. It does not run Claude Code plugin runtimes.
## Supported
- Workspace or global `.claude/skills/<name>/SKILL.md` directories discovered by
the normal skill registry.
- GitHub or tarball installs that contain one selected skill directory such as
`skills/<name>/SKILL.md`, `.agents/skills/<name>/SKILL.md`,
`.claude/skills/<name>/SKILL.md`, or a nested package layout ending in
`skills/<name>/SKILL.md`.
- Companion files inside the selected skill directory, such as `references/`,
`examples/`, or scripts that are only used after the skill is explicitly
loaded and trusted.
## Not Supported As A Plugin Runtime
Claude Code plugin features remain outside the v0.8.60 compatibility boundary:
- `.claude-plugin/plugin.json` metadata and activation semantics.
- Custom slash-command bundles.
- Plugin build steps, compiled TypeScript agents, dashboard servers, shared
plugin state, or token-gated service processes.
- Frontmatter fields that require Claude-specific runtime behavior, such as
`model: inherit`.
If a Claude Code plugin repository contains multiple skills, install or migrate
one `skills/<name>` directory at a time. `/skill install` rejects multi-skill
plugin archives with a clear message so it never silently chooses one skill and
drops the plugin runtime behavior.
For richer integrations, wrap the plugin's executable surface as MCP, hooks, or
a CodeWhale skill that names the external command explicitly.