CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-executions

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. Also load when a live run you started for the user fails with an error from a node or an external service (for example a 401), before you explain the cause to the user.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent operational skill body: every section carries n8n-specific semantics Claude could not infer, guidance is executable down to tool arguments and result fields, and validation/safety checkpoints are unusually thorough for operations that can touch real user data. The only refinements available are consolidating the repeated write-safety emphasis and splitting the tool-running deep-dive into a reference file.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (it never explains what n8n, a 401, or a credential is) and is dense with tool-specific semantics Claude cannot know ("workflowVersionId vs activeVersionId", "unreconstructable-context", "ranThroughNodeNames"). The write-safety rule is restated in several places ("Running one sends the message, charges the card, or deletes the row", "Mocked input does not make a write node safe", "The approval prompt alone is not consent"), which is deliberate emphasis but could be consolidated — efficient with minor trims, matching anchor 4 rather than anchor 3's genuinely unnecessary asides.

4 / 5

Actionability

Fully executable guidance with concrete invocations ("run_workflow_step(workflowId, nodeName, reuseExecutionId=<the failed execution>)", a complete toolArguments example, "get_resolved_node_parameters(executionId, nodeName)"), specific result fields ("failedExpressions", "emptyResolutions", "inputMode: 'mocked'"), and concrete decision rules (GET vs non-GET, safe-verb lists). The examples cover the common cases: auth errors, failed runs, wrong-output runs, tools, and sub-nodes.

5 / 5

Workflow Clarity

Explicit validation checkpoints and feedback loops run throughout: "Re-run the failing path ... and inspect the real result before responding", "Say what you checked before you say why it failed", the version check ("Only a row whose workflowVersionId equals workflow.activeVersionId ran the published code"), and "a new live run is what confirms the fix". The destructive-operation cap does not apply because the skill includes a full safety checklist ("Safe to run / Do not run for real / Unsure? Treat it as a write") and refused-replay recovery guidance; scenario-based rather than numbered organization suits a debugging skill.

5 / 5

Progressive Disclosure

Well-organized sections, core judgment rules correctly kept inline, and one clearly signaled external pointer ("read the workspace file knowledge-base/reference/trigger-input-data-shapes.md when a sandbox workspace is available"). It stops short of anchor 5 because the ~60-line "Running a tool" subsection is a specialized deep-dive that could live in a reference file and the ~243-line body is an operational manual rather than an overview — good structure with minor organization gaps, clearly above anchor 3's inlined-reference-material pattern.

4 / 5

Total

18

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete what-statement, explicit and multi-scope Load-when triggers covering user-reported failures and self-started live-run failures, and a distinct niche with negligible conflict risk. The only soft spot is that the capability statement rests on a single action verb rather than a list of several concrete operations.

DimensionReasoningScore

Specificity

The what-clause names one concrete action ("Debug failed or wrong-output workflow executions using executions tools") but enumerates highly concrete failure modes — "unexpected node output", "empty parameter values after a successful run", "a node showing a red or failed expression error", "(for example a 401)" — which lifts it above anchor 3's bare 1-2 action listing. It falls short of anchor 5 because it does not list several distinct concrete operations.

4 / 5

Completeness

Explicitly answers both questions: what = "Debug failed or wrong-output workflow executions using executions tools"; when = "Load when the user reports execution failures ... Also load when a live run you started for the user fails ... before you explain the cause to the user." This matches anchor 5's pattern of a clear what plus explicit when-clauses with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural report phrases are comprehensively covered — "execution failures", "unexpected node output", "empty parameter values", "failed expression error", "a live run ... fails with an error ... (for example a 401)" — with synonyms (run/execution, failed/error) and concrete error examples. Anchor 4 ("a few natural terms missing") does not fit: common variations like wrong output, empty value, and node error are all present.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — debugging n8n workflow executions via executions tools — with failure-report-shaped triggers ("execution failures", "expression error", "401") that are distinct from a workflow-building skill's triggers, keeping conflict risk minimal as anchor 5 requires.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

n8n-io/n8n

Path

packages/@n8n/instance-ai/skills/debugging-executions/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.