Claude Code plugin structure reorganized for n8n: namespace
n8n's Claude Code integration now lives in a dedicated plugin folder, giving all skills, agents, and commands a unified n8n: namespace prefix that prevents collisions with personal or third-party tools.
The Claude Code workspace for n8n has been restructured. Skills, agents, and commands that previously lived in top-level .claude/ directories are now consolidated under .claude/plugins/n8n/. This migration applies the n8n: namespace prefix to all items automatically — invocations like /n8n:create-pr, /n8n:plan, and the n8n:developer agent now work cleanly alongside any personal or third-party plugins developers might have installed.
The move resolves a limitation in Claude Code's plugin system: standalone .claude/skills/ entries cannot be namespaced, but plugin-based items receive a namespace derived from their plugin folder. To accommodate this, the name field has been removed from skill frontmatter — the directory path now serves as the identifier, and the plugin adds the n8n: prefix automatically.
Agent names have been updated accordingly: n8n-developer became developer and n8n-linear-issue-triager became linear-issue-triager, with the plugin system prepending n8n: at invocation time.
Documentation has been simplified across the board. The root now points to the plugin README for details rather than listing every command and skill inline, and the plugin README itself has been trimmed to essential structure and design decisions.
This reorganization supports the broader IAM-519 initiative to improve n8n's Claude Code integration.
View Original GitHub Description
Summary
Moves all Claude Code skills (10), agents (2), and commands (2) from top-level .claude/ directories into the existing .claude/plugins/n8n/ plugin folder. This gives everything the n8n: namespace prefix, avoiding naming collisions with personal or third-party plugins.
Also strips the name field from skill frontmatter (required for plugin skill namespacing per Claude Code bug #17271).
How to verify
- Open Claude Code in this repo
- Type
/n8n:and verify tab-completion shows all skills and commands (e.g./n8n:create-pr,/n8n:n8n-triage) - Verify agents appear with
n8n:prefix (e.g.n8n:n8n-developer) - Confirm old paths (
.claude/skills/,.claude/agents/,.claude/commands/) no longer exist
Related Linear tickets, Github issues, and Community forum posts
https://linear.app/n8n/issue/IAM-519
Review / Merge checklist
- PR title and summary are descriptive. (conventions)
- Docs updated or follow-up ticket created.
- Tests included.