Notes on Claude Code plugins. Gotchas, fixes, workarounds.
Skills with context: fork and agent: sometimes load inline into the main session instead of forking. The model tries to execute agent instructions directly in the chat — everything breaks.
Fix — add to CLAUDE.md:
# Plugin skill execution
When a plugin skill with `context: fork` and `agent:` is loaded inline instead of being forked automatically, you MUST manually spawn the specified agent using the Task tool. Pass the skill content as the prompt and use the agent specified in the frontmatter. Never process forked skill instructions inline — always delegate to the correct subagent.CLAUDE.md instructions are loaded into the system prompt and override default behavior — the model will delegate via Task tool even when auto-fork doesn't trigger.