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.
N8N Agent Skill System: Master Engineering Reference
Welcome to the N8N Agent Skill System. This repository provides the unified, authoritative capability for constructing reliable, production-ready n8n workflows and rigorously validating them before delivery.
Engineering Workflow Lifecycle
When creating or modifying an n8n workflow, you MUST follow this 7-step engineering process:
graph LR
A[1. Requirements & Spec] --> B[2. Pattern Selection]
B --> C[3. Node & Param Setup]
C --> D[4. Expressions & Flow]
D --> E[5. Error Resilience]
E --> F[6. 131-Rule Validation]
F --> G[7. Delivery & JSON Output]
1. Requirements & Spec Analysis
- Determine triggers: Webhook, Schedule/Cron, Chat, Event, or Subworkflow.
- Identify integrations: APIs, Databases (Postgres/MySQL/Supabase), Comms (Slack/Gmail/Telegram), LLMs/AI.
- Determine SLA, volume, and latency requirements.
2. Architectural Pattern Selection
- Refer to
skills/01-workflow-design-patterns/SKILL.md. - Choose: Synchronous Webhook, Asynchronous Queue, Paginated ETL Loop, AI Agent with Memory/Tools, or Subworkflow.
3. Node & Parameter Configuration
- Use modern, safe
typeVersions (seereferences/node-catalog.md). - Ensure all required parameters are present (e.g.
urlon HTTP Request,modelon LLMs). - Check
includeOtherInputFields: trueon Set nodes when preserving context.
4. Expression & Data Flow
- Use
{{ $json.fieldName }}for current items and$('Node Name').item.json.fieldfor previous nodes. - Strictly adhere to Luxon DateTime:
.toFormat('yyyy-MM-dd'),.plus({ days: 1 }),.toISO(). - Never use Moment.js methods (
.format(),.add(),.toISOString()).
5. Error Handling & Resilience
- Configure
onError: "continueErrorOutput"for nodes requiring fault isolation, and wire the dedicated error output port (index 1). - Set up retries for HTTP requests (
retryOnFail: true). - Include global
errorWorkfloworerrorTriggeralerting where appropriate.
6. Automated 131-Rule Validation
- Execute:
python scripts/validate_workflow.py <path_to_workflow.json> - Ensure 0 Errors and resolve any relevant warnings.
7. Output Delivery
- Output complete, 100% importable n8n workflow JSON (no pseudocode or truncated snippets).
Skill Directory Structure
skills/: 12 Specialized modular skills.scripts/: Executable Python validator (validate_workflow.py), scaffold generator, and workflow inspector.references/: Complete 131 validation rules catalog, node catalog JSON/MD, expression syntax guide, and code recipes.templates/: 7 Production-ready, verified workflow templates.
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 |