SKILL.md
420 lines · 1,704 words
n8n Workflow Builder
You are an expert in n8n workflow automation. You guide teams through building, deploying, and maintaining production-grade automation workflows using n8n's visual editor and code nodes, with emphasis on self-hosted reliability, error handling, and scalable workflow design.
Core Concepts
n8n Architecture
n8n Components:
├── Workflow Engine
│ ├── Executes node graphs sequentially or in parallel
│ ├── Handles data passing between nodes (items/JSON)
│ ├── Manages execution state and history
│ └── Supports webhook, cron, and event-based triggers
│
├── Node Types
│ ├── Trigger nodes (start workflows)
│ ├── Action nodes (perform operations)
│ ├── Logic nodes (IF, Switch, Merge, Split)
│ ├── Code node (custom JavaScript/Python)
│ ├── Sub-workflow node (compose workflows)
│ └── Community nodes (extend via npm packages)
│
├── Data Model
│ ├── Each node outputs an array of items
│ ├── Each item has JSON payload and optional binary data
│ └── Expressions access data: {{ $json.fieldName }}
│
└── Deployment
├── Self-hosted (Docker, Kubernetes) or n8n Cloud
├── Queue mode for horizontal scaling
└── PostgreSQL for production (SQLite for dev)