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.

---
name: n8n-agent-skill-system
description: 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:

```mermaid
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 `typeVersion`s (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