abbibo/N8N-Workflow-Builder-Agent-skills-N8N
n8n-agent-skill-system
VerifiedPrimary 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
| references/code-node-recipes.md | markdown | 2.6 KB |
| references/expression-syntax-guide.md | markdown | 2.6 KB |
| references/node-catalog.json | config | 95.9 KB |
| references/node-catalog.md | markdown | 5.1 KB |
| references/validation-rules-131.json | config | 15.9 KB |
| references/validation-rules-131.md | markdown | 13.1 KB |
| scripts/inspect_workflow.py | script | 1.0 KB |
| scripts/scaffold_workflow.py | script | 1.9 KB |
| scripts/validate_workflow.py | script | 21.7 KB |
| templates/ai-agent-rag-tools.json | config | 3.1 KB |
| templates/claudecode-bug-fixer.json | config | 3.6 KB |
| templates/error-trigger-handler.json | config | 2.6 KB |
| templates/paginated-api-ingestion.json | config | 3.7 KB |
| templates/scheduled-db-sync.json | config | 4.4 KB |
| templates/subworkflow-modular-child.json | config | 1.5 KB |
| templates/subworkflow-modular-parent.json | config | 2.5 KB |
| templates/webhook-crm-pipeline.json | config | 5.5 KB |
references/validation-rules-131.json
View on GitHub[
{
"id": 1,
"severity": "error",
"description": "name is a non-empty string"
},
{
"id": 2,
"severity": "error",
"description": "nodes is an array with at least one element"
},
{
"id": 3,
"severity": "error",
"description": "every node has a non-empty id"
},
{
"id": 4,
"severity": "error",
"description": "node ids are unique"
},
{
"id": 5,
"severity": "error",
"description": "every node has a non-empty type string"
},
{
"id": 6,
"severity": "error",
"description": "every node has a positive typeVersion number"
},
{
"id": 7,
"severity": "error",
"description": "every node has a valid [x, y] position"
},
{
"id": 8,
"severity": "error",
"description": "every node has a non-empty name"
},
{
"id": 9,
"severity": "error",
"description": "connections is a plain object"
},
{
"id": 10,
"severity": "error",
"description": "every connection target node name exists in nodes"
},
{
"id": 11,
"severity": "warn",
"description": "every non-trigger node has at least one incoming connection"
},
{
"id": 12,
"severity": "error",
"description": "forbidden fields absent from workflow root"
},
{
"id": 13,
"severity": "error",
"description": "settings, if present, is a plain object"
},
{
"id": 14,
"severity": "error",
"description": "at least one trigger node is present"
},
{
"id": 15,
"severity": "error",
"description": "node type string matches expected format"
},
{
"id": 16,
"severity": "error",
"description": "node names are unique within the workflow"
},
{
"id": 17,
"severity": "error",
"description": "credentials shape \u2014 each entry has id and name"
},
{
"id": 18,
"severity": "error",
"description": "AI connections must originate from sub-nodes, not the agent/chain root"
},
{
"id": 19,
"severity": "warn",
"description": "typeVersion is within known safe range for registered node types."
},
{
"id": 20,
"severity": "warn",
"description": "cycle detection \u2014 no node should be reachable from itself"
},
{
"id": 21,
"severity": "warn",
"description": "webhook with responseMode=\"responseNode\" must have respondToWebhook node"
},
{
"id": 22,
"severity": "warn",
"description": "check requiredParams from registry"
},
{
"id": 23,
"severity": "warn",
"description": "unknown node types not in registry"
},
{
"id": 24,
"severity": "warn",
"description": "deprecated accessor syntax in expressions"
},
{
"id": 25,
"severity": "warn",
"description": "wrong item index assumptions in expressions"
},
{
"id": 26,
"severity": "warn",
"description": "missing .first() or .all() on node references"
},
{
"id": 27,
"severity": "warn",
"description": "httpRequest URL is a placeholder"
},
{
"id": 28,
"severity": "warn",
"description": "code node with empty or comment-only code"
},
{
"id": 29,
"severity": "warn",
"description": "slack node message operation missing channel"
},
{
"id": 30,
"severity": "warn",
"description": "gmail node send operation missing recipient"
},
{
"id": 31,
"severity": "warn",
"description": "if node with empty conditions"
},
{
"id": 32,
"severity": "warn",
"description": "set node with no assignments"
},
{
"id": 33,
"severity": "warn",
"description": "scheduleTrigger with no schedule rules"
},
{
"id": 34,
"severity": "warn",
"description": "webhook path contains spaces, starts with slash, or looks like a full URL"
},
{
"id": 35,
"severity": "warn",
"description": "email-sending node with no duplicate-prevention signal"
},
{
"id": 36,
"severity": "warn",
"description": "Code node output field names don't match downstream $json references (camelCase vs snake_case)"
},
{
"id": 37,
"severity": "warn",
"description": "new Date() called on external data without a custom date parsing helper"
},
{
"id": 38,
"severity": "warn",
"description": "multiple parallel AI HTTP calls merge into same downstream node"
},
{
"id": 39,
"severity": "warn",
"description": "deprecated Claude model name in use"
},
{
"id": 40,
"severity": "warn",
"description": "__rl resource locator field has wrong shape (plain string instead of {__rl, mode, value})"
},
{
"id": 41,
"severity": "warn",
"description": "HTTP Request has body content but sendBody is not true"
},
{
"id": 42,
"severity": "warn",
"description": "SplitInBatches output 0 (\"done\") loops back into the batch node \u2014 outputs likely reversed"
},
{
"id": 43,
"severity": "warn",
"description": "IF/Filter node condition uses string operator instead of {type, operation} object (typeVersion 2+)"
},
{
"id": 44,
"severity": "warn",
"description": "Google Sheets append/update with columnMappingMode \"defineBelow\" but empty fieldsUi"
},
{
"id": 45,
"severity": "error",
"description": "AI Agent / chain node has no ai_languageModel sub-node connected"
},
{
"id": 46,
"severity": "warn",
"description": "HTTP Request has hardcoded API key / token in header values"
},
{
"id": 47,
"severity": "warn",
"description": "Switch node has output route(s) with no downstream connections"
},
{
"id": 48,
"severity": "warn",
"description": "deprecated OpenAI model name in use"
},
{
"id": 49,
"severity": "warn",
"description": "executeWorkflow node has no workflowId set"
},
{
"id": 50,
"severity": "warn",
"description": "AI Agent promptType \"auto\" with no chatTrigger or formTrigger upstream"
},
{
"id": 51,
"severity": "warn",
"description": "Wait node in webhook-resume mode with no resumeUrl sent downstream"
},
{
"id": 52,
"severity": "warn",
"description": "SQL injection risk \u2014 SQL query built with template literal + $json field in Code node"
},
{
"id": 53,
"severity": "warn",
"description": "Merge node mode incompatible with its incoming connection count"
},
{
"id": 54,
"severity": "warn",
"description": "HTTP Request to known protected API domain without credentials or auth headers"
},
{
"id": 55,
"severity": "warn",
"description": "Google Sheets sheetName is a placeholder literal when documentId is a real ID"
},
{
"id": 56,
"severity": "warn",
"description": "node has continueOnFail but no immediate downstream error check on $json.error"
},
{
"id": 57,
"severity": "warn",
"description": "HTTP Request binary upload with missing or empty binaryPropertyName"
},
{
"id": 58,
"severity": "warn",
"description": "wrong credential type key for the node type"
},
{
"id": 59,
"severity": "warn",
"description": "webhook node has no authentication configured"
},
{
"id": 60,
"severity": "warn",
"description": "scheduleTrigger fires every minute (cron minute=* or minutesInterval=1)"
},
{
"id": 61,
"severity": "warn",
"description": "toolWorkflow sub-node missing description"
},
{
"id": 62,
"severity": "warn",
"description": "memoryBufferWindow without chatTrigger and no sessionKey (shared memory)"
},
{
"id": 63,
"severity": "error",
"description": "duplicate webhook path+httpMethod in the same workflow"
},
{
"id": 65,
"severity": "error",
"description": "SplitInBatches batchSize <= 0"
},
{
"id": 66,
"severity": "error",
"description": "HTTP Request URL missing protocol prefix (not http:// or https://)"
},
{
"id": 67,
"severity": "warn",
"description": "Code node $('NodeName') references a node not in the workflow"
},
{
"id": 68,
"severity": "warn",
"description": "Google Calendar create event missing timezone"
},
{
"id": 69,
"severity": "warn",
"description": "Gmail send node missing subject"
},
{
"id": 70,
"severity": "warn",
"description": "Set node v1 with keepOnlySet=true drops all upstream fields"
},
{
"id": 71,
"severity": "warn",
"description": "toolWorkflow source=database missing workflowId"
},
{
"id": 72,
"severity": "warn",
"description": "Code node calls JSON.parse() without a try/catch"
},
{
"id": 73,
"severity": "warn",
"description": "AI tool sub-nodes (toolCode, toolHttpRequest, etc.) missing description"
},
{
"id": 74,
"severity": "warn",
"description": "multiple memoryBufferWindow nodes share the same static sessionKey"
},
{
"id": 75,
"severity": "warn",
"description": "emailSend node missing toAddresses, subject, or message"
},
{
"id": 76,
"severity": "warn",
"description": "Telegram sendMessage missing chatId"
},
{
"id": 77,
"severity": "warn",
"description": "Code node in runOnceForAllItems mode uses $json without $input.all()"
},
{
"id": 78,
"severity": "warn",
"description": "workflow has no errorWorkflow configured in settings"
},
{
"id": 79,
"severity": "warn",
"description": "HTTP Request URL contains \"webhook-test\" (test URL that expires)"
},
{
"id": 80,
"severity": "warn",
"description": "Set node v3+ has assignments but includeOtherInputFields is not enabled"
},
{
"id": 81,
"severity": "error",
"description": "executeWorkflow calls the current workflow (infinite loop)"
},
{
"id": 82,
"severity": "warn",
"description": "workflow has multiple SplitInBatches nodes (nested loop risk)"
},
{
"id": 83,
"severity": "error",
"description": "toolWorkflow source=parameter has no inline workflow nodes"
},
{
"id": 84,
"severity": "error",
"description": "toolWorkflow source=parameter inline workflow missing executeWorkflowTrigger entry point"
},
{
"id": 85,
"severity": "warn",
"description": "HTTP Request has both a credential and a manual Authorization header"
},
{
"id": 86,
"severity": "error",
"description": "scheduleTrigger cronExpression has wrong number of fields"
},
{
"id": 87,
"severity": "warn",
"description": "Merge combineByPosition with an upstream Filter node (item count mismatch)"
},
{
"id": 88,
"severity": "warn",
"description": "Telegram sendMessage missing text"
},
{
"id": 89,
"severity": "error",
"description": "chainRetrievalQa missing ai_retriever sub-node"
},
{
"id": 90,
"severity": "error",
"description": "respondToWebhook exists but no webhook has responseMode=\"responseNode\""
},
{
"id": 91,
"severity": "warn",
"description": "filter node has empty conditions (Rule 31 handles IF node; this handles Filter)"
},
{
"id": 92,
"severity": "error",
"description": "expression calls .toISOString() on a Luxon DateTime ($now/$today)"
},
{
"id": 93,
"severity": "warn",
"description": "expression calls .format() (Moment.js API) instead of .toFormat() (Luxon API)"
},
{
"id": 94,
"severity": "warn",
"description": "toolCode AI tool node has no executable code"
},
{
"id": 95,
"severity": "error",
"description": "toolHttpRequest AI tool has no URL defined"
},
{
"id": 96,
"severity": "warn",
"description": "AI Agent/chain has multiple ai_languageModel sub-nodes (n8n only uses index 0)"
},
{
"id": 97,
"severity": "error",
"description": "vectorStore node missing ai_embedding sub-node"
},
{
"id": 98,
"severity": "error",
"description": "outputParserStructured has no JSON schema"
},
{
"id": 99,
"severity": "warn",
"description": "chainLlm with output parser connected but {format_instructions} missing from prompt"
},
{
"id": 100,
"severity": "error",
"description": "Postgres / MySQL executeQuery node has empty SQL query"
},
{
"id": 101,
"severity": "warn",
"description": "formTrigger has no form fields defined"
},
{
"id": 102,
"severity": "error",
"description": "splitOut node missing fieldToSplitOut parameter"
},
{
"id": 103,
"severity": "warn",
"description": "Code node returns array items without the required json wrapper"
},
{
"id": 105,
"severity": "error",
"description": "LM model parameter set to a non-routable alias (\"latest\", \"default\", etc.)"
},
{
"id": 106,
"severity": "warn",
"description": "Switch fallbackOutput is enabled but the fallback output port has no downstream connection"
},
{
"id": 107,
"severity": "warn",
"description": "trigger node expression references $json (no upstream data at trigger time)"
},
{
"id": 108,
"severity": "warn",
"description": "aggregate node in field-specific mode with no fields to aggregate"
},
{
"id": 109,
"severity": "warn",
"description": "Airtable create/update/upsert node with no field mappings"
},
{
"id": 110,
"severity": "warn",
"description": "agent with promptType=\"define\" but text is empty"
},
{
"id": 111,
"severity": "warn",
"description": "ai_languageModel connection targets a non-agent/chain node"
},
{
"id": 112,
"severity": "error",
"description": "Luxon .add() or .subtract() used in expressions (Moment.js methods)"
},
{
"id": 113,
"severity": "warn",
"description": "IF node with unconnected true or false output branch"
},
{
"id": 114,
"severity": "warn",
"description": "$('NodeName') in expressions references a node that does not exist"
},
{
"id": 115,
"severity": "warn",
"description": "SplitInBatches output 1 (loop body) has no path that loops back"
},
{
"id": 116,
"severity": "error",
"description": "LM sub-node using a model name from the wrong provider"
},
{
"id": 117,
"severity": "warn",
"description": "Google Calendar create event missing start or end time"
},
{
"id": 118,
"severity": "warn",
"description": "Redis node missing key (propertyName) for key-based operations"
},
{
"id": 119,
"severity": "error",
"description": "Supabase node missing tableId"
},
{
"id": 120,
"severity": "warn",
"description": "Gmail reply operation missing messageId"
},
{
"id": 121,
"severity": "warn",
"description": "splitOut fieldToSplitOut contains a dot (dot-path navigation attempt)"
},
{
"id": 122,
"severity": "warn",
"description": "Luxon .plus() or .minus() called with positional (n, 'unit') arguments"
},
{
"id": 123,
"severity": "warn",
"description": "HTTP Request sendQuery=true but queryParameters is empty"
},
{
"id": 124,
"severity": "warn",
"description": "Code node in runOnceForAllItems mode has no return statement"
},
{
"id": 125,
"severity": "warn",
"description": "Luxon uppercase YYYY or DD tokens in .toFormat() calls"
},
{
"id": 126,
"severity": "warn",
"description": "Node ID does not match UUID v4 format"
},
{
"id": 127,
"severity": "warn",
"description": "Code node language/param mismatch \u2014 jsCode/pythonCode populated for the wrong language"
},
{
"id": 128,
"severity": "warn",
"description": "onError \"continueErrorOutput\" set but the dedicated error output port (index 1) is unwired"
},
{
"id": 129,
"severity": "warn",
"description": "node's resource/operation value doesn't exist in the real n8n schema for its type"
},
{
"id": 130,
"severity": "warn",
"description": "AWS S3 / Slack file upload missing binaryPropertyName"
},
{
"id": 131,
"severity": "warn",
"description": "long unbranched node chain (15+ nodes, no If/Switch/Merge/Filter) \u2014 consolidation opportunity"
}
]Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |