n8n-debugging-official

Find the cause before reaching for a workaround.

workflow debugging

What it does

Diagnoses n8n workflow failures systematically, starting with cheap checks and escalating to source investigation when needed.

When to use it

Use when an n8n workflow errors, stops, produces unexpected results, or the user says it is not working.

It changes how the agent diagnoses n8n workflow problems, checks executions and configuration, and reports confirmed causes or workarounds.

What you provide

This skill

n8n workflows and executions

Read

Reads workflows and executions

n8n workflow tests

Execute

Pinned workflow tests

n8n documentation

Read

Reads n8n API documentation

n8n source and GitHub issues

Read

Reads source and GitHub issues

An n8n MCP connection must provide workflow, execution, node-type, validation, and testing tools used by the procedure.