Skip to content
Back to search

n8n-io

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/n8n-io/skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/n8n-io/skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/n8n-io--skills/badge.svg)](/listings/n8n-io--skills)

HTML

<a href="/listings/n8n-io--skills"><img src="/api/listings/n8n-io--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Pick your platform:

- [Claude Code (CLI)](#claude-code-cli) - [Claude Code (Desktop app)](#claude-code-desktop-app) - [Codex](#codex) - [OpenCode (CLI)](#opencode-cli) - [OpenCode (Desktop app)](#opencode-desktop-app) - [Other platforms](#other-platforms)

Claude Code (CLI)

Inside a `claude` session:

1. **Add the marketplace.** Run `/plugin marketplace add n8n-io/skills`. 2. **Install the plugin.** Run `/plugin install n8n-skills@n8n-io`, enter your **n8n instance URL** when prompted, then run `/reload-plugins`. - Just the base URL, e.g. `https://acme.app.n8n.cloud` (no path) — the plugin adds `/mcp-server/http`. 3. **Authorize the MCP.** Run `/mcp`, select **n8n-mcp**, and choose **Authenticate** to sign in via your browser.

> Already run the n8n MCP elsewhere? This adds its own `n8n-mcp` connection. Disable it from `/mcp` to avoid a duplicate toolset.

Claude Code (Desktop app)

1. **Add the marketplace.** In the prompt box, run `/plugin marketplace add n8n-io/skills`. 2. **Install.** Click **+** next to the prompt box → **Plugins** → **Add plugin**, select **n8n-skills** in the plugin browser, and pick a scope. Enter your **n8n instance URL** when prompted (just the base URL, e.g. `https://acme.app.n8n.cloud` — the plugin adds `/mcp-server/http`). - No prompt? Set it with `/plugin configure n8n-skills@n8n-io`, then reload. 3. **Authorize the MCP.** Open **Settings → Connectors**, find **n8n-mcp**, and connect (browser sign-in).

Codex

> Requires **Codex ≥ 0.142.0** (root-plugin marketplace support). Works in the Codex CLI and the Codex mode of the ChatGPT desktop app.

In a terminal:

1. **Add the marketplace.** Run `codex plugin marketplace add n8n-io/skills`. 2. **Install the plugin.** Run `codex plugin add n8n-skills@n8n-io`, then restart Codex and approve the hook-trust prompt (enables the SessionStart, PreToolUse, and PostToolUse reminders). 3. **Add the MCP server.** Codex can't auto-configure it, so add it once (Codex has no config prompt like Claude Code):

   codex mcp add n8n-mcp --url https://<your-n8n-domain>/mcp-server/http

- No terminal (desktop app only)? Add it in the GUI: **Settings → MCP servers → Add server → Streamable HTTP**, paste the URL, save, then **Restart**. 4. **Authorize the MCP.** Codex signs in via OAuth on first use, or click **Authenticate** in the MCP servers list.

OpenCode (CLI)

Add one line to your `opencode.jsonc` (global `~/.config/opencode/`, or a project `.opencode/`) and restart:

{
  "plugin": ["n8n-skills@git+https://github.com/n8n-io/skills.git"]
}

OpenCode fetches and installs the plugin, which registers the n8n skills and fires the bash hooks after n8n MCP tool calls. No clone, symlink, or `skills.paths`. Pin a version with `...skills.git#v1.2.0`.

OpenCode (Desktop app)

The desktop app loads plugins from `~/.config/opencode/plugins/`. Get the repo (clone, or download and unzip [the ZIP](https://github.com/n8n-io/skills/archive/refs/heads/main.zip)), then symlink the plugin file into that folder:

git clone https://github.com/n8n-io/skills.git ~/.local/share/opencode/n8n-skills
mkdir -p ~/.config/opencode/plugins/
ln -s ~/.local/share/opencode/n8n-skills/opencode/plugin.ts \
      ~/.config/opencode/plugins/n8n-skills-hooks.ts

Fully quit and reopen the app. The plugin self-registers its skills, so no `skills.paths` is needed. Update later with `git pull` in the clone (or re-download the ZIP).

See [`opencode/README.md`](./opencode/README.md) for prerequisites and the experimental-API caveat.

Other platforms

> *Each coding agent has its own skill format. Follow your platform's docs for installing skills*

[skills.sh](https://skills.sh) handles a few popular platforms via `npx`. From your project folder:

npx skills add n8n-io/skills

Compatibility varies by agent. Check skills.sh for support on your specific platform.

Then add a snippet to your `AGENTS.md`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "n8n-io",
  3. "owner": {
  4. "name": "n8n",
  5. "url": "https://n8n.io"
  6. },
  7. "plugins": [
  8. {
  9. "name": "n8n-skills",
  10. "source": "./",
  11. "description": "Production-grade n8n workflow building skills for Claude Code. Pairs with the official n8n MCP server.",
  12. "version": "1.3.0",
  13. "category": "automation",
  14. "tags": ["n8n", "workflow", "automation", "mcp"]
  15. }
  16. ]
  17. }
README.md · README · 157 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Official n8n Skills
  2. <!-- TODO: add 15-second demo gif before the tagline -->
  3. **n8n's MCP makes the connection. n8n Skills set the standard.**
  4. Built by the n8n team to pair with n8n's instance-level MCP server. Your coding agent can now build and edit workflows through the MCP, organize them into folders and projects, and build n8n Agents. The skills enable it to get it right the first time.
  5. **What's inside:**
  6. - **The n8n MCP connection, set up for you** (Claude Code): the plugin bundles the `n8n-mcp` server and prompts for your instance URL at install, so there's no manual MCP config. Codex adds it with one `codex mcp add`.
  7. - **14 capability skills** covering best practices across the full workflow lifecycle: sub-workflow reuse, expressions, loops and pagination, n8n Agents, AI nodes, error handling, credentials, Data Tables, debugging, and more.
  8. - **50+ reference docs and worked examples** loaded on demand: per-node gotchas, decision trees, and copy-pasteable workflow JSON / TypeScript SDK snippets.
  9. - **A SessionStart hook** that loads the protocol on every session, including a compact reference for every n8n MCP tool.
  10. - **PreToolUse hooks** that nudge your agent to consult the matching skill before high-impact MCP calls.
  11. ## Prerequisite
  12. An n8n instance (any plan, Cloud or self-hosted) with the instance-level MCP server enabled (**Settings → Instance-level MCP**). Minimum **n8n 2.2.0**; for best results, run the latest stable. See [n8n's MCP setup guide](https://docs.n8n.io/build/ways-of-building-workflows/connect-to-n8n-mcp-server/?utm_source=github&utm_medium=readme&utm_campaign=official-skills-repo).
  13. ## Install
  14. Pick your platform:
  15. - [Claude Code (CLI)](#claude-code-cli)
  16. - [Claude Code (Desktop app)](#claude-code-desktop-app)
  17. - [Google Antigravity](#google-antigravity)
  18. - [Codex](#codex)
  19. - [OpenCode (CLI)](#opencode-cli)
  20. - [OpenCode (Desktop app)](#opencode-desktop-app)
  21. - [Other platforms](#other-platforms)
  22. ### Claude Code (CLI)
  23. Inside a `claude` session:
  24. 1. **Add the marketplace.** Run `/plugin marketplace add n8n-io/skills`.
  25. 2. **Install the plugin.** Run `/plugin install n8n-skills@n8n-io`, enter your **n8n instance URL** when prompted, then run `/reload-plugins`.
  26. - Just the base URL, e.g. `https://acme.app.n8n.cloud` (no path) — the plugin adds `/mcp-server/http`.
  27. 3. **Authorize the MCP.** Run `/mcp`, select **n8n-mcp**, and choose **Authenticate** to sign in via your browser.
  28. > Already run the n8n MCP elsewhere? This adds its own `n8n-mcp` connection. Disable it from `/mcp` to avoid a duplicate toolset.
  29. ### Claude Code (Desktop app)
  30. 1. **Add the marketplace.** In the prompt box, run `/plugin marketplace add n8n-io/skills`.
  31. 2. **Install.** Click **+** next to the prompt box → **Plugins** → **Add plugin**, select **n8n-skills** in the plugin browser, and pick a scope. Enter your **n8n instance URL** when prompted (just the base URL, e.g. `https://acme.app.n8n.cloud` — the plugin adds `/mcp-server/http`).
  32. - No prompt? Set it with `/plugin configure n8n-skills@n8n-io`, then reload.
  33. 3. **Authorize the MCP.** Open **Settings → Connectors**, find **n8n-mcp**, and connect (browser sign-in).
  34. ### Google Antigravity
  35. Build the native Antigravity bundle with `pnpm build:antigravity`, then install `dist/antigravity/`. It includes all 15 skills and the MCP connection with native OAuth. See the [Antigravity setup guide](.antigravity-plugin/README.md). The build preserves the shared skills and existing client adapters.
  36. ### Codex
  37. > Requires **Codex ≥ 0.142.0** (root-plugin marketplace support). Works in the Codex CLI and the Codex mode of the ChatGPT desktop app.
  38. In a terminal:
  39. 1. **Add the marketplace.** Run `codex plugin marketplace add n8n-io/skills`.
  40. 2. **Install the plugin.** Run `codex plugin add n8n-skills@n8n-io`, then restart Codex and approve the hook-trust prompt (enables the SessionStart, PreToolUse, and PostToolUse reminders).
  41. 3. **Add the MCP server.** Codex can't auto-configure it, so add it once (Codex has no config prompt like Claude Code):
  42. ```bash
  43. codex mcp add n8n-mcp --url https://<your-n8n-domain>/mcp-server/http
  44. ```
  45. - No terminal (desktop app only)? Add it in the GUI: **Settings → MCP servers → Add server → Streamable HTTP**, paste the URL, save, then **Restart**.
  46. 4. **Authorize the MCP.** Codex signs in via OAuth on first use, or click **Authenticate** in the MCP servers list.
  47. ### OpenCode (CLI)
  48. Add one line to your `opencode.jsonc` (global `~/.config/opencode/`, or a project `.opencode/`) and restart:
  49. ```jsonc
  50. {
  51. "plugin": ["n8n-skills@git+https://github.com/n8n-io/skills.git"]
  52. }
  53. ```
  54. OpenCode fetches and installs the plugin, which registers the n8n skills and fires the bash hooks after n8n MCP tool calls. No clone, symlink, or `skills.paths`. Pin a version with `...skills.git#v1.2.0`.
  55. ### OpenCode (Desktop app)
  56. The desktop app loads plugins from `~/.config/opencode/plugins/`. Get the repo (clone, or download and unzip [the ZIP](https://github.com/n8n-io/skills/archive/refs/heads/main.zip)), then symlink the plugin file into that folder:
  57. ```bash
  58. git clone https://github.com/n8n-io/skills.git ~/.local/share/opencode/n8n-skills
  59. mkdir -p ~/.config/opencode/plugins/
  60. ln -s ~/.local/share/opencode/n8n-skills/opencode/plugin.ts \
  61. ~/.config/opencode/plugins/n8n-skills-hooks.ts
  62. ```
  63. Fully quit and reopen the app. The plugin self-registers its skills, so no `skills.paths` is needed. Update later with `git pull` in the clone (or re-download the ZIP).
  64. See [`opencode/README.md`](./opencode/README.md) for prerequisites and the experimental-API caveat.
  65. ### Other platforms
  66. > *Each coding agent has its own skill format. Follow your platform's docs for installing skills*
  67. [skills.sh](https://skills.sh) handles a few popular platforms via `npx`. From your project folder:
  68. ```bash
  69. npx skills add n8n-io/skills
  70. ```
  71. Compatibility varies by agent. Check skills.sh for support on your specific platform.
  72. #### Then add a snippet to your `AGENTS.md`
  73. ```markdown
  74. This project uses n8n. When working with workflows, nodes, expressions, or
  75. the n8n MCP tools, always start by loading the `using-n8n-skills-official` meta-skill
  76. and follow its routing into the matching capability skill before acting.
  77. ```
  78. > *The plugins activate the entry-point skill through native hooks or rules. Plain skill installs don't include those reminders, so the snippet is what cues your agent to start every n8n task by loading `using-n8n-skills-official`.*
  79. ## Skills inside
  80. | Skill | When it activates |
  81. |---|---|
  82. | `n8n-workflow-lifecycle-official` | Starting, designing, organizing, or finishing a workflow |
  83. | `n8n-subworkflows-official` | Anything reusable, multi-step builds |
  84. | `n8n-extending-mcp-official` | Need capabilities the MCP doesn't have |
  85. | `n8n-expressions-official` | Writing `{{}}`, `$json`, `$node` |
  86. | `n8n-node-configuration-official` | Configuring any node |
  87. | `n8n-code-nodes-official` | Custom logic, Code node consideration |
  88. | `n8n-loops-official` | Loops, batching, paginated APIs |
  89. | `n8n-agents-official` | Building n8n Agents: Agent vs workflow, tools, approvals, skills, sub-agents, memory, channels, tasks |
  90. | `n8n-ai-nodes-official` | AI inside workflows: AI Agent node, classifiers, extractors, chains, RAG, chat bot workflows |
  91. | `n8n-error-handling-official` | Webhook APIs, production workflows |
  92. | `n8n-credentials-and-security-official` | Auth, API keys, tokens |
  93. | `n8n-binary-and-data-official` | Files, images, attachments, vision |
  94. | `n8n-data-tables-official` | Data Tables: schemas, dedup, persistent state |
  95. | `n8n-debugging-official` | Things break |
  96. A 15th meta-skill, `using-n8n-skills-official`, is loaded by the SessionStart hook in plugins and routes your agent to the right capability skill on every n8n task.
  97. ## How it works
  98. Each skill is a markdown file. Frontmatter tells the agent when to load it. Claude Code and Codex load the router through SessionStart hooks; PreToolUse hooks pull matching skills back into context before high-impact MCP calls. Antigravity uses an always-on rule to load its entry skill. It's all just markdown. Disagree with a call? Fork it.
  99. ## Related
  100. - [Connect to the n8n MCP server](https://docs.n8n.io/build/ways-of-building-workflows/connect-to-n8n-mcp-server/?utm_source=github&utm_medium=readme&utm_campaign=official-skills-repo)
  101. - [n8n](https://n8n.io?utm_source=github&utm_medium=readme&utm_campaign=official-skills-repo)
  102. ## Contributing
  103. See [CLAUDE.md](./CLAUDE.md), the contributing guide for humans and AI agents alike. **Open an issue first.** We don't accept PRs that haven't been discussed in an issue.
  104. **Looking for contributors:** feature parity plugins for other coding agents (Cursor, OpenCode, etc.). The skills are just markdown, the work is wrapping them so they activate in those harnesses the way they do in Claude Code.
  105. ## License
  106. Apache 2.0. See [LICENSE](./LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.