Official agent skill

Debugging Executions

by n8n-io in n8n-io/n8n

Debug failed or wrong-output workflow executions using executions tools.

OfficialCustom licenceAuto-check passedDevelopment

Install Debugging Executions

skills CLI
$ npx skills add n8n-io/n8n --skill debugging-executions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install n8n-io/n8n debugging-executions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/n8n-io/n8n.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/@n8n/instance-ai/skills/debugging-executions .claude/skills/debugging-executions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debugging-executions
GitHub stars
207k
Token cost
~2.6k tokens
SKILL.md length
1,502 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Debug failed or wrong-output workflow executions using executions tools.

  • Reports execution failures
  • SKILL.md covers When the user reports it still…, Draft versus live, Testing event-triggered… and Failed execution, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Unexpected node output

What it does

Debugging Executions is an agent skill from n8n-io/n8n, published by the product's own GitHub organization. Debug failed or wrong-output workflow executions using executions tools. Load when the user reports execution failures, unexpected node output, empty parameter values after a successful run, or a node showing a red or failed expression error.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Debugging and Workflow automation. It works with n8n and Model Context Protocol. The repository describes itself as: Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

When your agent uses it

  • Reports execution failures
  • Unexpected node output
  • Empty parameter values after a successful run
  • A node showing a red

Example prompts

  • “/debugging-executions”

What it can do on your machine

Read from SKILL.md and the folder at commit 60ad29f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debugging Executions loads about 2.6k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 1,502 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,502 words (~2,556 tokens).

“Use this skill when debugging workflow execution failures or successful runs with wrong or empty values.”

— opening of SKILL.md by n8n-io, Custom licence
name
debugging-executions
recommended_tools
executions, workflows

Read the full SKILL.md on GitHub

Files

Just SKILL.md in packages/@n8n/instance-ai/skills/debugging-executions of n8n-io/n8n.

Open the folder on GitHubat commit 60ad29f

Compare with similar skills

Debugging Executions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debugging Executions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debugging Executions this skilln8n-io/n8n207k—~2.6kAutomated safety check: PassCustom licence
n8n Multi-Instance Targetingczlonkowski/n8n-skills6.4k—~3.2kAutomated safety check: PassMIT
Agents Onboardingfazer-ai/agents118—~4.4kAutomated safety check: PassApache-2.0
Apify Integration Developmentapify/agent-skills2.4k—~3.1kAutomated safety check: PassNone
N8n MCP Tools Expertdavila7/claude-code-templates32k8 repos~3.2kAutomated safety check: PassMIT
n8n MCP Tools Expertczlonkowski/n8n-skills6.4k—~7.6kAutomated safety check: PassMIT

Similar skills

  • n8n Multi-Instance Targeting

    czlonkowski/n8n-skills

    Keeps an n8n MCP session pointed at the right n8n instance, with rules for discovering, switching and verifying the target before credential writes and for recovering from misroutes.

    6.4k GitHub stars~3.2k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed
  • Agents Onboarding

    fazer-ai/agents

    Conduz a jornada de onboarding 'do zero ao agente de atendimento' do fazer.ai agents num VPS, escolhendo o orquestrador de deploy (Tier A Coolify, B Portainer, C compose genérico para VM crua ou…

    118 GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Official

    Guides designing and building an official Apify integration for a company's product: workflow-automation apps, AI agent plugins, AI framework packages or direct API clients.

    2.4k GitHub stars~3.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • N8n MCP Tools Expert

    davila7/claude-code-templates

    Expert guide for using n8n-mcp MCP tools effectively. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 8 repos~3.2k tokens
    Productivity & AutomationAuto-check passed
  • n8n MCP Tools Expert

    czlonkowski/n8n-skills

    Guides the agent in choosing and calling n8n-mcp tools: finding nodes, validating configurations, deploying templates, managing workflows, folders and credentials, and auditing an instance.

    6.4k GitHub stars~7.6k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed
  • N8n Workflows

    vibeeval/vibecosystem

    n8n otomasyon workflow'lari. An agent skill from vibeeval/vibecosystem.

    531 GitHub stars~3.3k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

More from n8n-io/n8n

All 12 skills in this repo
  • N8n CLI

    n8n-io/n8n

    Official

    Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance.

    207k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Official

    Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs.

    207k GitHub stars~550 tokensUpdated today
    Auto-check passed
  • Official

    Load before calling build-workflow. An agent skill from n8n-io/n8n.

    207k GitHub stars~15k tokensUpdated today
    Auto-check: warnings
  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Official

    Offer the three most common automations for a user as a single-choice card, from your own knowledge of their team and their apps, then build the one they choose once they confirm, or offer more.

    207k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Debugging Executions

What does Debugging Executions do?

Debug failed or wrong-output workflow executions using executions tools. Debugging Executions is an agent skill from n8n-io/n8n, published by the product's own GitHub organization. Debug failed or wrong-output workflow executions using executions tools.

When should I use Debugging Executions?

Debugging Executions fits situations like: reports execution failures; unexpected node output; empty parameter values after a successful run; A node showing a red.

How do I install Debugging Executions in Claude Code?

Run `npx skills add n8n-io/n8n --skill debugging-executions -a claude-code`. Or copy the skill folder (packages/@n8n/instance-ai/skills/debugging-executions in n8n-io/n8n) into .claude/skills/debugging-executions in your project. Claude Code loads it when a task matches its description.

How do I install Debugging Executions in Codex?

Run `npx skills add n8n-io/n8n --skill debugging-executions -a codex`. Or copy the skill folder (packages/@n8n/instance-ai/skills/debugging-executions in n8n-io/n8n) into .agents/skills/debugging-executions in your project. Codex loads it when a task matches its description.

Can I use Debugging Executions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add n8n-io/n8n --skill debugging-executions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debugging-executions, .gemini/skills/debugging-executions, .github/skills/debugging-executions and .opencode/skills/debugging-executions in your project.

What does Debugging Executions need to run?

SKILL.md names no scripts, command-line tools or credentials: Debugging Executions is instructions for the agent only.

Does Debugging Executions access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Debugging Executions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Debugging Executions use?

Debugging Executions has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Debugging Executions use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debugging Executions?

Skills that share tags, products or a category with Debugging Executions: n8n Multi-Instance Targeting (czlonkowski/n8n-skills, 6.4k stars), Agents Onboarding (fazer-ai/agents, 118 stars), Apify Integration Development (apify/agent-skills, 2.4k stars) and N8n MCP Tools Expert (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debugging Executions?

n8n-io (a GitHub organization, an official publisher) maintains it in n8n-io/n8n, which has 206,847 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

Source: n8n-io/n8n on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.