czlonkowski /n8n-skills
n8n skillset for Claude Code to build flawless n8n workflows
★ 6,651⑂ 1,082👁 64⑃ 39● 32▤ 7
+6
Daily
6,651
stars
1,082
forks
64
watchers
39
prs
32
issues
7
releases
README
n8n-skills
Expert Claude Code skills for building flawless n8n workflows using the n8n-mcp MCP server
Watch the Introduction Video
💼 Need it built for you? Work with AiAdvisors — n8n automation audits, builds, and operations, run by the author of n8n-mcp and n8n-skills.
---
🎯 What is this?
This repository contains 14 complementary Claude Code skills — plus an always-on router skill and a hooks enforcement layer — that teach AI assistants how to build production-ready n8n workflows using the n8n-mcp MCP server, and how to deploy the self-hosted n8n that runs them.
Why These Skills Exist
Building n8n workflows programmatically can be challenging. Common issues include:
- Using MCP tools incorrectly or inefficiently
- Getting stuck in validation error loops
- Not knowing which workflow patterns to use
- Misconfiguring nodes and their dependencies
These skills solve these problems by teaching Claude:
- ✅ Correct n8n expression syntax ({{}} patterns)
- ✅ How to use n8n-mcp tools effectively
- ✅ Proven workflow patterns from real-world usage
- ✅ Validation error interpretation and fixing
- ✅ Operation-aware node configuration
---
📚 The 14 Skills
1. n8n Expression Syntax
Teaches correct n8n expression syntax and common patterns.
Activates when: Writing expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors.
Key Features:
- Core variables ($json, $node, $now, $env)
- Critical gotcha: Webhook data is under $json.body
- Common mistakes catalog with fixes
- The transform gatekeeper: service node → native node → short expression → Code; a function body in {{ }} is code
- Built-in helpers (.pluck(), .sum(), $ifEmpty(), .diffTo()), expression-only
2. n8n MCP Tools Expert (HIGHEST PRIORITY)
Expert guide for using n8n-mcp MCP tools effectively.
Activates when: Searching for nodes, validating configurations, accessing templates, managing workflows.
Key Features:
- Tool selection guide (which tool for which task)
- nodeType format differences (nodes-base. vs n8n-nodes-base.)
- Validation profiles (minimal/runtime/ai-friendly/strict)
- Smart parameters (branch="true" for IF nodes)
- Auto-sanitization system explained
Most Important: Teaches correct MCP tool usage patterns and parameter formats
3. n8n Workflow Patterns
Build workflows using 5 proven architectural patterns.
Activates when: Creating workflows, connecting nodes, designing automation.
Key Features:
- 5 proven patterns (webhook processing, HTTP API, database, AI, scheduled)
- Workflow creation checklist
- Real examples from 2,653+ n8n templates
- Connection best practices
- Pattern selection guide
4. n8n Validation Expert
Interpret validation errors and guide fixing.
Activates when: Validation fails, debugging workflow errors, handling false positives.
Key Features:
- Validation loop workflow
- Real error catalog
- Auto-sanitization behavior explained
- False positives guide
- Profile selection for different stages
5. nTop issues
#69n8n-subworkflows recommends mode: each, which n8n v3 removes (Migration Report rule execute-workflow-each-mode-v3)0 comments · 2026-10-19#68Possible use in VS Code GitHub Copilot with Copilot Harness?0 comments · 2026-10-18#60JavaScript Each Item examples return arrays and fail on n8n 2.35.40 comments · 2026-10-02#5814 compétences n8n0 comments · 2026-09-24#56Broken relative link in n8n-workflow-patterns/webhook_processing.md0 comments · 2026-09-23#54SessionStart hook fails on Windows: python3 resolves to Microsoft Store alias stub, not a real interpreter0 comments · 2026-09-22#52PostToolUse hook for `validate_workflow` never fires for `n8n_validate_workflow`0 comments · 2026-09-09#45Feature Request: Compatibility with Google Antigravity v2 & CLI (hooks.json structure)0 comments · 2026-07-21
Latest release
v1.37.1 — native-first node selection v1.37.1 2026-10-24The first release with native-first node selection (70, PRs 71 and 72). It also ships the unreleased 1.36.0 per-call instance docs. Built to match n8n-mcp 2.97.0 (czlonkowski/n8n-mcp1194). Native first, Code last - Router (using-n8n-mcp-skills): pick in this order: the service's own node (HTTP Request only when no node covers the operation), then a native node for the job, then a short expression in that node, then Code. A job-to-node table names the node for each common job (Summarize, Aggregate, Split Out, Merge, Compare Datasets, Remove Duplicates, Sort + Limit, Date & Time, XML / HTML /