Skip to content

abbibo/N8N-Workflow-Builder-Agent-skills-N8N

n8n-agent-skill-system

Verified

Primary engineering skill for designing, generating, validating, and delivering complete, importable, production-ready n8n workflows using Antigravity and Agentic IDEs. Implements 131 automated validation rules, comprehensive node catalogs, Luxon DateTime verification, AI agent architectures, and modular subworkflows.

references/validation-rules-131.md

View on GitHub
# N8N 131-Rule Comprehensive Validation Matrix\n\nThis catalog documents the complete 131 validation rules enforced by the N8N Agent Skill System to guarantee structural, operational, logical, and expression integrity of every generated workflow.\n\n| Rule ID | Severity | Description | Category |\n| :--- | :--- | :--- | :--- |\n| Rule 001 | `ERROR` | name is a non-empty string | Structural |\n| Rule 002 | `ERROR` | nodes is an array with at least one element | Structural |\n| Rule 003 | `ERROR` | every node has a non-empty id | Structural |\n| Rule 004 | `ERROR` | node ids are unique | Structural |\n| Rule 005 | `ERROR` | every node has a non-empty type string | Structural |\n| Rule 006 | `ERROR` | every node has a positive typeVersion number | Structural |\n| Rule 007 | `ERROR` | every node has a valid [x, y] position | Structural |\n| Rule 008 | `ERROR` | every node has a non-empty name | Structural |\n| Rule 009 | `ERROR` | connections is a plain object | Structural |\n| Rule 010 | `ERROR` | every connection target node name exists in nodes | Structural |\n| Rule 011 | `WARN` | every non-trigger node has at least one incoming connection | Structural |\n| Rule 012 | `ERROR` | forbidden fields absent from workflow root | Structural |\n| Rule 013 | `ERROR` | settings, if present, is a plain object | Structural |\n| Rule 014 | `ERROR` | at least one trigger node is present | Structural |\n| Rule 015 | `ERROR` | node type string matches expected format | Structural |\n| Rule 016 | `ERROR` | node names are unique within the workflow | Structural |\n| Rule 017 | `ERROR` | credentials shape — each entry has id and name | Structural |\n| Rule 018 | `ERROR` | AI connections must originate from sub-nodes, not the agent/chain root | Structural |\n| Rule 019 | `WARN` | typeVersion is within known safe range for registered node types. | Structural |\n| Rule 020 | `WARN` | cycle detection — no node should be reachable from itself | Structural |\n| Rule 021 | `WARN` | webhook with responseMode="responseNode" must have respondToWebhook node | Operations & Logic |\n| Rule 022 | `WARN` | check requiredParams from registry | Operations & Logic |\n| Rule 023 | `WARN` | unknown node types not in registry | Operations & Logic |\n| Rule 024 | `WARN` | deprecated accessor syntax in expressions | Expressions |\n| Rule 025 | `WARN` | wrong item index assumptions in expressions | Expressions |\n| Rule 026 | `WARN` | missing .first() or .all() on node references | Expressions |\n| Rule 027 | `WARN` | httpRequest URL is a placeholder | Operations & Logic |\n| Rule 028 | `WARN` | code node with empty or comment-only code | Operations & Logic |\n| Rule 029 | `WARN` | slack node message operation missing channel | Operations & Logic |\n| Rule 030 | `WARN` | gmail node send operation missing recipient | Operations & Logic |\n| Rule 031 | `WARN` | if node with empty conditions | Operations & Logic |\n| Rule 032 | `WARN` | set node with no assignments | Operations & Logic |\n| Rule 033 | `WARN` | scheduleTrigger with no schedule rules | Operations & Logic |\n| Rule 034 | `WARN` | webhook path contains spaces, starts with slash, or looks like a full URL | Operations & Logic |\n| Rule 035 | `WARN` | email-sending node with no duplicate-prevention signal | Operations & Logic |\n| Rule 036 | `WARN` | Code node output field names don't match downstream $json references (camelCase vs snake_case) | Operations & Logic |\n| Rule 037 | `WARN` | new Date() called on external data without a custom date parsing helper | Operations & Logic |\n| Rule 038 | `WARN` | multiple parallel AI HTTP calls merge into same downstream node | Operations & Logic |\n| Rule 039 | `WARN` | deprecated Claude model name in use | Operations & Logic |\n| Rule 040 | `WARN` | __rl resource locator field has wrong shape (plain string instead of {__rl, mode, value}) | Operations & Logic |\n| Rule 041 | `WARN` | HTTP Request has body content but sendBody is not true | Operations & Logic |\n| Rule 042 | `WARN` | SplitInBatches output 0 ("done") loops back into the batch node — outputs likely reversed | Operations & Logic |\n| Rule 043 | `WARN` | IF/Filter node condition uses string operator instead of {type, operation} object (typeVersion 2+) | Operations & Logic |\n| Rule 044 | `WARN` | Google Sheets append/update with columnMappingMode "defineBelow" but empty fieldsUi | Operations & Logic |\n| Rule 045 | `ERROR` | AI Agent / chain node has no ai_languageModel sub-node connected | AI / LangChain |\n| Rule 046 | `WARN` | HTTP Request has hardcoded API key / token in header values | Operations & Logic |\n| Rule 047 | `WARN` | Switch node has output route(s) with no downstream connections | Operations & Logic |\n| Rule 048 | `WARN` | deprecated OpenAI model name in use | Operations & Logic |\n| Rule 049 | `WARN` | executeWorkflow node has no workflowId set | Operations & Logic |\n| Rule 050 | `WARN` | AI Agent promptType "auto" with no chatTrigger or formTrigger upstream | AI / LangChain |\n| Rule 051 | `WARN` | Wait node in webhook-resume mode with no resumeUrl sent downstream | Operations & Logic |\n| Rule 052 | `WARN` | SQL injection risk — SQL query built with template literal + $json field in Code node | Operations & Logic |\n| Rule 053 | `WARN` | Merge node mode incompatible with its incoming connection count | Operations & Logic |\n| Rule 054 | `WARN` | HTTP Request to known protected API domain without credentials or auth headers | Operations & Logic |\n| Rule 055 | `WARN` | Google Sheets sheetName is a placeholder literal when documentId is a real ID | Operations & Logic |\n| Rule 056 | `WARN` | node has continueOnFail but no immediate downstream error check on $json.error | Operations & Logic |\n| Rule 057 | `WARN` | HTTP Request binary upload with missing or empty binaryPropertyName | Operations & Logic |\n| Rule 058 | `WARN` | wrong credential type key for the node type | Operations & Logic |\n| Rule 059 | `WARN` | webhook node has no authentication configured | Operations & Logic |\n| Rule 060 | `WARN` | scheduleTrigger fires every minute (cron minute=* or minutesInterval=1) | Operations & Logic |\n| Rule 061 | `WARN` | toolWorkflow sub-node missing description | AI / LangChain |\n| Rule 062 | `WARN` | memoryBufferWindow without chatTrigger and no sessionKey (shared memory) | AI / LangChain |\n| Rule 063 | `ERROR` | duplicate webhook path+httpMethod in the same workflow | Operations & Logic |\n| Rule 065 | `ERROR` | SplitInBatches batchSize <= 0 | Operations & Logic |\n| Rule 066 | `ERROR` | HTTP Request URL missing protocol prefix (not http:// or https://) | Operations & Logic |\n| Rule 067 | `WARN` | Code node $('NodeName') references a node not in the workflow | Operations & Logic |\n| Rule 068 | `WARN` | Google Calendar create event missing timezone | Operations & Logic |\n| Rule 069 | `WARN` | Gmail send node missing subject | Operations & Logic |\n| Rule 070 | `WARN` | Set node v1 with keepOnlySet=true drops all upstream fields | Operations & Logic |\n| Rule 071 | `WARN` | toolWorkflow source=database missing workflowId | Operations & Logic |\n| Rule 072 | `WARN` | Code node calls JSON.parse() without a try/catch | Operations & Logic |\n| Rule 073 | `WARN` | AI tool sub-nodes (toolCode, toolHttpRequest, etc.) missing description | AI / LangChain |\n| Rule 074 | `WARN` | multiple memoryBufferWindow nodes share the same static sessionKey | AI / LangChain |\n| Rule 075 | `WARN` | emailSend node missing toAddresses, subject, or message | Operations & Logic |\n| Rule 076 | `WARN` | Telegram sendMessage missing chatId | Operations & Logic |\n| Rule 077 | `WARN` | Code node in runOnceForAllItems mode uses $json without $input.all() | Operations & Logic |\n| Rule 078 | `WARN` | workflow has no errorWorkflow configured in settings | Operations & Logic |\n| Rule 079 | `WARN` | HTTP Request URL contains "webhook-test" (test URL that expires) | Operations & Logic |\n| Rule 080 | `WARN` | Set node v3+ has assignments but includeOtherInputFields is not enabled | Operations & Logic |\n| Rule 081 | `ERROR` | executeWorkflow calls the current workflow (infinite loop) | Operations & Logic |\n| Rule 082 | `WARN` | workflow has multiple SplitInBatches nodes (nested loop risk) | Operations & Logic |\n| Rule 083 | `ERROR` | toolWorkflow source=parameter has no inline workflow nodes | AI / LangChain |\n| Rule 084 | `ERROR` | toolWorkflow source=parameter inline workflow missing executeWorkflowTrigger entry point | AI / LangChain |\n| Rule 085 | `WARN` | HTTP Request has both a credential and a manual Authorization header | Operations & Logic |\n| Rule 086 | `ERROR` | scheduleTrigger cronExpression has wrong number of fields | Operations & Logic |\n| Rule 087 | `WARN` | Merge combineByPosition with an upstream Filter node (item count mismatch) | Operations & Logic |\n| Rule 088 | `WARN` | Telegram sendMessage missing text | Operations & Logic |\n| Rule 089 | `ERROR` | chainRetrievalQa missing ai_retriever sub-node | AI / LangChain |\n| Rule 090 | `ERROR` | respondToWebhook exists but no webhook has responseMode="responseNode" | Operations & Logic |\n| Rule 091 | `WARN` | filter node has empty conditions (Rule 31 handles IF node; this handles Filter) | Operations & Logic |\n| Rule 092 | `ERROR` | expression calls .toISOString() on a Luxon DateTime ($now/$today) | Expressions |\n| Rule 093 | `WARN` | expression calls .format() (Moment.js API) instead of .toFormat() (Luxon API) | Expressions |\n| Rule 094 | `WARN` | toolCode AI tool node has no executable code | AI / LangChain |\n| Rule 095 | `ERROR` | toolHttpRequest AI tool has no URL defined | AI / LangChain |\n| Rule 096 | `WARN` | AI Agent/chain has multiple ai_languageModel sub-nodes (n8n only uses index 0) | AI / LangChain |\n| Rule 097 | `ERROR` | vectorStore node missing ai_embedding sub-node | AI / LangChain |\n| Rule 098 | `ERROR` | outputParserStructured has no JSON schema | AI / LangChain |\n| Rule 099 | `WARN` | chainLlm with output parser connected but {format_instructions} missing from prompt | AI / LangChain |\n| Rule 100 | `ERROR` | Postgres / MySQL executeQuery node has empty SQL query | Operations & Logic |\n| Rule 101 | `WARN` | formTrigger has no form fields defined | Operations & Logic |\n| Rule 102 | `ERROR` | splitOut node missing fieldToSplitOut parameter | Operations & Logic |\n| Rule 103 | `WARN` | Code node returns array items without the required json wrapper | Operations & Logic |\n| Rule 105 | `ERROR` | LM model parameter set to a non-routable alias ("latest", "default", etc.) | AI / LangChain |\n| Rule 106 | `WARN` | Switch fallbackOutput is enabled but the fallback output port has no downstream connection | Operations & Logic |\n| Rule 107 | `WARN` | trigger node expression references $json (no upstream data at trigger time) | Operations & Logic |\n| Rule 108 | `WARN` | aggregate node in field-specific mode with no fields to aggregate | Operations & Logic |\n| Rule 109 | `WARN` | Airtable create/update/upsert node with no field mappings | Operations & Logic |\n| Rule 110 | `WARN` | agent with promptType="define" but text is empty | AI / LangChain |\n| Rule 111 | `WARN` | ai_languageModel connection targets a non-agent/chain node | AI / LangChain |\n| Rule 112 | `ERROR` | Luxon .add() or .subtract() used in expressions (Moment.js methods) | Expressions |\n| Rule 113 | `WARN` | IF node with unconnected true or false output branch | Operations & Logic |\n| Rule 114 | `WARN` | $('NodeName') in expressions references a node that does not exist | Operations & Logic |\n| Rule 115 | `WARN` | SplitInBatches output 1 (loop body) has no path that loops back | Operations & Logic |\n| Rule 116 | `ERROR` | LM sub-node using a model name from the wrong provider | AI / LangChain |\n| Rule 117 | `WARN` | Google Calendar create event missing start or end time | Operations & Logic |\n| Rule 118 | `WARN` | Redis node missing key (propertyName) for key-based operations | Operations & Logic |\n| Rule 119 | `ERROR` | Supabase node missing tableId | Operations & Logic |\n| Rule 120 | `WARN` | Gmail reply operation missing messageId | Operations & Logic |\n| Rule 121 | `WARN` | splitOut fieldToSplitOut contains a dot (dot-path navigation attempt) | Operations & Logic |\n| Rule 122 | `WARN` | Luxon .plus() or .minus() called with positional (n, 'unit') arguments | Expressions |\n| Rule 123 | `WARN` | HTTP Request sendQuery=true but queryParameters is empty | Operations & Logic |\n| Rule 124 | `WARN` | Code node in runOnceForAllItems mode has no return statement | Operations & Logic |\n| Rule 125 | `WARN` | Luxon uppercase YYYY or DD tokens in .toFormat() calls | Expressions |\n| Rule 126 | `WARN` | Node ID does not match UUID v4 format | Operations & Logic |\n| Rule 127 | `WARN` | Code node language/param mismatch — jsCode/pythonCode populated for the wrong language | Operations & Logic |\n| Rule 128 | `WARN` | onError "continueErrorOutput" set but the dedicated error output port (index 1) is unwired | Operations & Logic |\n| Rule 129 | `WARN` | node's resource/operation value doesn't exist in the real n8n schema for its type | Operations & Logic |\n| Rule 130 | `WARN` | AWS S3 / Slack file upload missing binaryPropertyName | Operations & Logic |\n| Rule 131 | `WARN` | long unbranched node chain (15+ nodes, no If/Switch/Merge/Filter) — consolidation opportunity | Operations & Logic |\n
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall