n8n-debug

Classify and diagnose errors in n8n workflows.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/apexradius/agentic-os --skill n8n-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n8n-debug
Source: https://github.com/apexradius/agentic-os/tree/main/skills/n8n-debug
Command: npx skills add https://github.com/apexradius/agentic-os --skill n8n-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The n8n-debug Skill helps you diagnose and resolve issues in n8n workflows by providing a structured approach to error classification and logging analysis.

Core Features & Use Cases

  • Error Classification: Classifies n8n failures into categories like Connection, Authentication, Data/Mapping, and Logic/Flow errors.
  • Detailed Diagnosis: Offers specific steps and considerations for diagnosing and fixing common issues.
  • Execution Log Analysis: Provides commands to read execution logs for in-depth error analysis.
  • n8n Gotchas: Highlights common issues and solutions in n8n, like credential expiry or webhook URL changes.
  • Use Case: When you encounter a failed n8n workflow, this skill helps identify the issue, apply the fix, and ensure that your automations resume smoothly.

Quick Start

To start debugging, run 'n8n-debug' and provide either the JSON path to the problematic workflow data or a description of the error you are encountering.

Frequently Asked Questions about n8n-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a failed n8n workflow?

Troubleshoot n8n authentication errors by classifying them through this diagnostic skill. It identifies credential expiry issues and provides specific steps to resolve authentication failures within your automation workflows.

Why does my n8n workflow fail to connect to an API integration?

n8n workflow API integration failures are diagnosed by classifying connection issues and analyzing execution logs. This skill provides commands to read logs and highlights common n8n gotchas like webhook URL changes that cause connection drops.

How do I analyze execution logs for n8n automation errors?

Fix n8n data mapping mistakes by diagnosing them through structured error classification. The skill identifies Data/Mapping errors within your workflow structure and offers specific steps to correct the data processing logic.

Do I need n8n workflow structure knowledge to diagnose automation failures?

Yes, diagnosing automation failures requires knowledge of n8n workflow structure and common pitfalls. This prerequisite allows you to effectively validate API integrations and apply the specific fixes provided by the error classification.