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 |
SKILL.md
View on GitHub---
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.
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 |