N8n Workflow Bauen

n8n-Workflow bauen

n8n ist ein Werkzeug, mit dem man Apps ohne Programmieren verbinden kann: "Wenn eine Mail mit Rechnung ankommt, lege sie in Google Drive ab und trage sie in eine Tabelle ein." Dieser Skill baut solche Workflows aus einer einfachen Beschreibung.

Zwei Wege, je nachdem, was der Nutzer hat:

• Weg A: JSON zum Importieren. Kein API-Key nötig. Der Skill baut den Workflow als Datei, der Nutzer importiert sie in n8n mit zwei Klicks. Der Standardweg für Einsteiger.
• Weg B: Direkt deployen. Mit n8n-API-Key baut und testet der Skill den Workflow direkt in der n8n-Instanz, Node für Node.

Wann dieser Skill greift

Wenn ein wiederkehrender Ablauf automatisiert werden soll und n8n das Werkzeug ist (oder werden soll). Auch für Fragen zu einzelnen Nodes, Expressions und Code-Nodes.

Konnektoren

• n8n-API-Key (optional): ermöglicht Weg B. Beim Start prüfen: Liegt im Arbeitsverzeichnis eine .env mit N8N_API_URL und N8N_API_KEY, oder nennt der Nutzer beides? Wenn nicht: in einem Satz erwähnen, dass mit API-Key direkt deployt und getestet werden könnte, und mit Weg A weiterarbeiten.

Ablauf

Schritt 1: Den Ablauf verstehen

Bevor irgendetwas gebaut wird, den Ablauf in Alltagssprache festnageln:

1. Auslöser: Was startet den Workflow? (Zeitplan, eingehende Mail, Formular, Webhook)
2. Schritte: Was passiert dann, der Reihe nach? Welche Apps sind beteiligt?
3. Daten: Welche Information fließt von Schritt zu Schritt?
4. Fehlerfall: Was soll passieren, wenn ein Schritt scheitert?

Den verstandenen Ablauf als nummerierte Liste zurückspiegeln und bestätigen lassen. Wenn der Nutzer Tools nennt (z. B. "mit Google Sheets"), genau diese verwenden, nie stillschweigend ersetzen.

Schritt 2: Bauen

Regeln für beide Wege (Details: references/bau-regeln.md):

• Native n8n-Nodes vor HTTP-Request vor Code-Node. Code nur, wo Logik es wirklich braucht
• Für KI-Aufgaben den AI-Agent- oder Chat-Model-Node verwenden
• Keine Platzhalter-Daten ("REPLACE_ME"): Wo eine echte Angabe fehlt (Tabellen-ID, Kanalname), den Nutzer fragen oder die Stelle klar als "in n8n auswählen" markieren
• Sinnvolle Node-Namen ("Rechnung erkennen" statt "IF 1")

Weg A (JSON): Den kompletten Workflow als eine JSON-Datei ins Arbeitsverzeichnis schreiben (workflow-[name].json, ohne Umlaute im Dateinamen), nach dem Strukturmuster in references/workflow-json.md. Danach die Import-Anleitung geben (drei Schritte, steht in derselben Referenz) und erklären, welche Zugangsdaten (Credentials) der Nutzer in n8n noch anklicken muss: Credentials wandern nie ins JSON.

Weg B (API): Nach dem Prozess in references/api-deploy.md: Workflow mit Trigger anlegen, dann einen Node nach dem anderen hinzufügen und nach jedem Node testen (Ausführung prüfen, erst bei Erfolg weiter). Nie mehrere ungetestete Nodes stapeln. Bei Fehlern die Ursache beheben, nicht auf eine "einfachere" Architektur ausweichen. Workflows aktualisieren statt löschen und neu anlegen. Beim Testen datenholende Nodes auf 2 Elemente begrenzen. Nur an Workflows arbeiten, die der Nutzer genannt hat.

Schritt 3: Übergeben

Am Ende bekommt der Nutzer:

• Weg A: die JSON-Datei, die Import-Anleitung, die Liste der noch zu verbindenden Credentials, und einen Testvorschlag ("Führ den Workflow einmal manuell mit einer Test-Mail aus")
• Weg B: den Workflow-Link, den Status (aktiv/inaktiv), was getestet wurde, und was noch manuell zu tun ist

Plus in beiden Fällen zwei Sätze, was der Workflow tut, so dass der Nutzer es einem Kollegen erklären könnte.

Hilfe bei Nodes, Expressions und Code

Auch ohne Workflow-Auftrag hilft der Skill bei Einzelfragen. Spickzettel in references/expressions-code.md:

• Expressions ({{ $json.feld }}), Zugriff auf andere Nodes, Datumsformate
• Die Webhook-Falle: eingehende Daten liegen unter $json.body, nicht direkt unter $json
• Code-Nodes in JavaScript und Python, mit den Rückgabe-Regeln

Wofür dieser Skill nicht da ist

• Die Entscheidung, OB n8n das richtige Werkzeug ist, gehört an den Anfang: Für einmalige Aufgaben oder reine Text-Arbeit ist Claude selbst schneller, für starre Wenn-dann-Abläufe zwischen Apps ist n8n ideal. Das ehrlich sagen
• n8n-Hosting und Server-Betrieb (auf n8n-Cloud oder die offizielle Doku verweisen)
• Zapier- und Make-Workflows (die Logik ist übertragbar, das JSON nicht)