Skills
.Work. You
Rest

n8n-debugging

Official

Diagnose broken n8n workflows fast.

Software Engineering#error handling#n8n#parameter validation#MCP tools#workflow debugging#execution inspection#expression debugging
Authorn8n-io
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you figure out why an n8n workflow fails or produces incorrect results, turning vague “it’s not working” reports into a structured diagnosis.

Core Features & Use Cases

  • Systematic root-cause triage that prioritizes cheap checks first (parameter misconfiguration, stale assumptions, wiring/connection issues).
  • Execution- and workflow-grounded investigation using tools like get_execution and get_workflow_details to confirm the failed node, inputs, and actual runtime behavior.
  • n8n-specific debugging heuristics for common failure patterns such as upstream data stripped, lost item context after fan-out/aggregate steps, logical errors, and genuine bugs, with guidance to consult n8n source when needed.
  • Version drift handling by prompting for n8n instance version and skills plugin update timing when behavior diverges from expectations.
  • Practical escalation and workaround guidance via community and GitHub issue paths when the bug is confirmed.

Quick Start

Ask the skill to debug your issue by stating what you expected, what happened, the error message (if any), and when it last worked.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: n8n-debugging
Download link: https://github.com/n8n-io/skills/archive/main.zip#n8n-debugging

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.