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.

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 (see references/node-catalog.md).
  • Ensure all required parameters are present (e.g. url on HTTP Request, model on LLMs).
  • Check includeOtherInputFields: true on Set nodes when preserving context.

4. Expression & Data Flow

  • Use {{ $json.fieldName }} for current items and $('Node Name').item.json.field for 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 errorWorkflow or errorTrigger alerting 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.
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