n8n-v2

Comprehensive n8n v2.0 reference for building workflow automation. Use this skill when working with n8n workflows, especially for (1) creating workflow JSON files for import, (2) implementing human-in-the-loop approval workflows with Wait nodes, (3) troubleshooting Execute Sub-Workflow node issues, (4) setting up API credentials (LinkedIn, Anthropic, NewsAPI), (5) building orchestrator patterns with sub-workflows, (6) using expressions in nodes, (7) understanding MCP server limitations, or (8) any n8n workflow development task.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill serves as a comprehensive technical reference for n8n v2.0, designed to accelerate the development of complex workflow automations. It provides expert guidance on building scalable orchestrator patterns, implementing human-in-the-loop approval processes, and mastering n8n's expression syntax. By offering production-ready templates and troubleshooting solutions for common API and node issues, it enables users to create robust, low-code automation solutions for diverse business needs.

Use Cases

  • Architecting multi-workflow orchestration patterns to manage complex, inter-dependent business processes efficiently.
  • Implementing human-in-the-loop (HITL) workflows using Wait nodes to ensure manual oversight and data validation at critical steps.
  • Troubleshooting and resolving technical bottlenecks, such as 'Out of Date' sub-workflow errors or complex OAuth2 credential configurations for LinkedIn and Anthropic APIs.
  • Generating and optimizing workflow JSON files for seamless import into n8n, including custom JavaScript snippets for advanced data deduplication and normalization.
  • Developing AI-powered content generation pipelines by integrating LLM APIs with n8n's logic nodes and sub-workflow triggers.
namen8n-v2
descriptionComprehensive n8n v2.0 reference for building workflow automation. Use this skill when working with n8n workflows, especially for (1) creating workflow JSON files for import, (2) implementing human-in-the-loop approval workflows with Wait nodes, (3) troubleshooting Execute Sub-Workflow node issues, (4) setting up API credentials (LinkedIn, Anthropic, NewsAPI), (5) building orchestrator patterns with sub-workflows, (6) using expressions in nodes, (7) understanding MCP server limitations, or (8) any n8n workflow development task.

n8n v2.0 Workflow Development

Overview

Comprehensive reference for building n8n workflows using v2.0 patterns and best practices. This skill provides complete documentation for nodes, expressions, patterns, troubleshooting, and production-ready examples.


Quick Start Guide

1. Test APIs First

curl -X GET "https://api.example.com/endpoint" \
  -H "Authorization: Bearer $TOKEN"

2. Create Workflow JSON

Generate workflow JSON with nodes and connections.

3. Import into n8n

n8n UI > Settings > Import from File

4. Configure & Fix

  • Replace Execute Sub-Workflow nodes (if needed)
  • Configure credentials
  • Test each node

5. Test Execution

Use MCP server mcp__n8n__execute_workflow or manual trigger


Core Concepts

n8n MCP Server Integration

What it CAN do:

  • ✅ Search workflows
  • ✅ View workflow details
  • ✅ Execute workflows

What it CANNOT do:

  • ❌ Create workflows
  • ❌ Modify workflows
  • ❌ Manage credentials

Workaround: Generate JSON files, import via UI

📖 Deep dive: references/mcp-limitations.md


Node Library

Complete reference for all n8n nodes:

Trigger Nodes: Manual Trigger, Execute Workflow Trigger Data Processing: Code, Set, Merge, Filter, Split in Batches Flow Control: IF, Wait Integration: HTTP Request, RSS Feed Read Action: Execute Workflow, Respond to Webhook

Each node documented with configuration examples, parameters, and patterns.

📖 Complete reference: references/node-library.md


Expression Syntax

Dynamic values in node parameters using ={{ expression }}:

{{ $json.field }}                      // Current item
{{ $('Node Name').first().json.field }} // Cross-node
{{ $json.url || 'default' }}           // Fallback
{{ new Date().toISOString() }}         // Date/time
`urn:li:person:${$json.sub}`          // Template literal

📖 Complete guide: references/expression-syntax.md


Common Workflows

Human-in-the-Loop Approval

Use Wait nodes with forms (NOT respondToWebhook):

Trigger → Generate Content → Wait Node (form) → IF → Action

📖 Complete patterns: references/wait-nodes-guide.md


Multi-Workflow Orchestration

Orchestrator coordinates sub-workflows:

Main Orchestrator
├── Trigger
├── Execute Sub-Workflow: Data Fetcher
├── Wait Node: Review
├── Execute Sub-Workflow: Processor
└── Execute Sub-Workflow: Output

📖 All patterns: references/workflow-patterns.md


News Aggregation

Multi-source data fetch, normalize, merge, deduplicate, rank:

Trigger
├── HTTP Request: Source 1 → Normalize
├── HTTP Request: Source 2 → Normalize
└── RSS Feed: Source 3 → Normalize
    → Merge → Deduplicate → Rank

📖 Detailed patterns: references/workflow-patterns.md


AI Content Generation

Sub-workflow pattern for AI content:

Execute Workflow Trigger
→ Code: Build Prompt
→ HTTP Request: AI API
→ Code: Extract Response

📖 Implementation: references/workflow-patterns.md


Critical Issues & Solutions

Execute Sub-Workflow "Out of Date" Error

Problem: Imported nodes show error after import

Solution:

  1. Delete old Execute Sub-Workflow nodes
  2. Add fresh nodes from palette
  3. Select "Database" and choose workflow

📖 Detailed troubleshooting: references/execute-sub-workflow-issues.md


Wait Node Not Pausing

❌ Wrong: respondToWebhook, Set nodes, IF on unset fields ✅ Correct: Wait node with resume: "form"

📖 Complete guide: references/wait-nodes-guide.md


LinkedIn unauthorized_scope_error

❌ Turn OFF both: "Organization Support" and "Legacy" toggles

📖 All auth issues: references/api-credentials.md


Templates & Examples

Basic Templates

Starting points for common structures:

  • assets/templates/wait-node-approval-template.json
  • assets/templates/orchestrator-template.json
  • assets/templates/sub-workflow-template.json

Complete Workflow Examples

Production-ready workflows you can import and use:

  • News Aggregation - Multi-source fetch, normalize, deduplicate, rank assets/examples/news-aggregation-workflow.json

  • Content Generation - AI-powered content creation sub-workflow assets/examples/content-generation-workflow.json

  • LinkedIn Member ID - Retrieve your LinkedIn member URN assets/examples/linkedin-member-id-workflow.json

  • Multi-Source Deduplication - Merge and deduplicate pattern assets/examples/multi-source-deduplication-workflow.json


Code Snippet Library

Reusable JavaScript for Code nodes:

  • Deduplication - Remove duplicates by URL, title, ID, or multiple fields code-snippets/deduplication.js

  • Ranking Algorithms - Multi-factor ranking (relevance, recency, engagement) code-snippets/ranking-algorithms.js

  • Data Normalization - Unify data from different API sources code-snippets/data-normalization.js

  • Form Data Preparation - Format data for Wait node forms code-snippets/form-data-preparation.js

  • Cross-Node Data Access - Reference data from other nodes code-snippets/cross-node-data-access.js


API Credentials Quick Reference

LinkedIn OAuth2:

  • Scopes: openid, profile, w_member_social
  • ❌ OFF: Organization Support, Legacy
  • URN format: urn:li:person:{id}

Anthropic API:

  • Header: x-api-key
  • Model: claude-3-5-sonnet-20241022
  • Temp: 0.7, Max tokens: 400

NewsAPI:

  • Header: X-Api-Key
  • Endpoints: /v2/everything, /v2/top-headlines
  • Free tier: 100 requests/day

📖 Complete setup: references/api-credentials.md


Reference Documentation

Core References


Official n8n Documentation