n8n Skill

Complete n8n skill for AI agents. 9 domains plus a workflow vector DB — covering workflow building, node configuration, code nodes, expression syntax, validation, MCP tools, credentials, administration, and data tables. Includes semantic search over 6,902 real n8n workflows so you can find a reference before building from scratch. Built from n8n source code and production workflows at D1DX.

Extends czlonkowski/n8n-skills with source-code-verified credential management, internal API reference, data tables, folder management, and a unified entry point.

What's Included

| Domain | Source | What it covers | |--------|--------|---------------| | Workflow Vector DB | D1DX | Semantic search over 6,902 real n8n workflows. Find a reference before building from scratch. | | Workflow Patterns | czlonkowski | 5 architectural patterns — webhook, HTTP API, database, AI agent, scheduled | | Node Configuration | czlonkowski | Operation-aware config, property dependencies, required fields | | Code — JavaScript | czlonkowski | $input/$json/$node syntax, $helpers.httpRequest(), DateTime, error patterns | | Code — Python | czlonkowski | _input/_json syntax, standard library, limitations | | Expression Syntax | czlonkowski | {{ }} expressions, $json/$node variables, common mistakes | | Validation | czlonkowski | Validation errors/warnings, false positives, profiles | | MCP Tools | czlonkowski | Tool selection, parameter formats, workflow management patterns | | Credentials | D1DX | Type discovery, credential testing (3 strategies), OAuth1/OAuth2 flows, httpCustomAuth, isPartialData updates | | Administration | D1DX | Data tables (full CRUD + CSV), folder management, community packages, Docker deployment, CLI commands, backup/restore |

Install

Claude Code

git clone --recursive https://github.com/D1DX/n8n-skill.git
cp -r n8n-skill ~/.claude/skills/n8n

Or as a git submodule:

git submodule add https://github.com/D1DX/n8n-skill.git path/to/skills/n8n

Other AI Agents

Copy SKILL.md (and subfolders) into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.

Verify

Start a new session. The skill should appear as n8n.

Recommended: n8n MCP Server

This skill works standalone but is designed to pair with an n8n MCP server for full workflow management. The skill provides knowledge; the MCP provides live instance access.

Compatible MCP servers:

| MCP Server | What it adds | |-----------|-------------| | czlonkowski/n8n-mcp | Node search, validation, smart workflow updates, template deployment | | leonardsellem/n8n-mcp-server | Workflow CRUD, execution management |

Structure

n8n-skill/
├── SKILL.md              — Unified entry point (auto-triggers on n8n tasks)
├── workflow-vectordb/
│   ├── REFERENCE.md      — Setup, usage, search quality benchmarks
│   ├── search.py         — Compact search (terminal or AI assistant)
│   ├── query.py          — Full search with --json and reranking
│   ├── ingest.py         — Build ChromaDB from repos or summaries
│   └── summaries.jsonl   — 6,902 pre-extracted summaries
├── credentials/
│   └── SKILL.md          — Credential types, testing, OAuth, httpCustomAuth
├── administration/
│   └── SKILL.md          — Data tables, folders, packages, Docker, CLI, backup
└── czlonkowski/          — Git submodule: czlonkowski/n8n-skills
    └── skills/
        ├── n8n-code-javascript/
        ├── n8n-code-python/
        ├── n8n-expression-syntax/
        ├── n8n-mcp-tools-expert/
        ├── n8n-node-configuration/
        ├── n8n-validation-expert/
        └── n8n-workflow-patterns/

Method Priority

The skill teaches when to use each method:

| Priority | Method | Use for | |----------|--------|---------| | 0 | Workflow Vector DB | Find a real reference workflow before building | | 1 | MCP | Workflow CRUD, node search, validation, templates, executions | | 2 | Public REST API | Credential CRUD, tags, variables, data table rows | | 3 | Internal API | Credential testing, folders, community packages, column CRUD | | 4 | CLI | Decrypted credential export, full database backup, migration rollback | | 5 | Docker/Infra | Encryption key, database config, version upgrades, logs |

Updating

The czlonkowski submodule tracks upstream. To update:

cd path/to/n8n-skill
git submodule update --remote czlonkowski
git add czlonkowski
git commit -m "chore: update n8n-skills submodule"

Sources

• Workflow Vector DB: 6,902 workflows from Danitilahun/n8n-workflow-templates, enescingoz/awesome-n8n-templates, and the n8n.io template API. Embeddings via Voyage AI voyage-code-3.
• Credentials and Administration: Verified against n8n-io/n8n source code (master branch, March 2026). Controllers read: credentials.controller.ts, credentials-tester.service.ts, data-table.controller.ts, folder.controller.ts, community-packages.controller.ts, oauth2-credential.controller.ts.
• Workflow building domains: czlonkowski/n8n-skills (MIT License).

Credits

Workflow building skills by Maciej Czlonkowski. Credentials, administration, and unified skill by D1DX. Workflow vector DB by Asaf Lecht.

License

MIT License — Copyright (c) 2026 Daniel Rudaev @ D1DX