CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

n8n-validation-expert

Expert guide for interpreting and fixing n8n validation errors.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/n8n-validation-expert/SKILL.md

The canonical home for this skill is n8n-validation-expert in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The body delivers strong, actionable domain content with a well-sequenced validate-fix-revalidate loop and explicit recovery branches. Its main weaknesses are repetition (telemetry stats stated three times, error types listed twice, a redundant Summary), broken references to nonexistent detail files, and catalog-level content that belongs in those referenced files.

Suggestions

Create the referenced ERROR_CATALOG.md and FALSE_POSITIVES.md files (or remove the 'Detailed Guides' section) — the links currently point to files that do not exist in the bundle.

Cut the repeated telemetry statistics ("7,841 occurrences", "23s thinking / 58s fixing") and the closing Summary section, which restates earlier sections almost verbatim.

Merge the 'Error Severity Levels' type list with the 'Common Error Types' section so each error type appears once with its fix, and show one concrete `get_node` call since it is repeatedly prescribed as the first step.

DimensionReasoningScore

Conciseness

The bulk is dense, genuinely non-obvious domain knowledge (error types, validation profiles, auto-sanitization rules, false-positive guidance), but there is noticeable padding: the telemetry stats ("7,841 occurrences", "23 seconds thinking", "58 seconds fixing") are repeated three times, the five error types are listed in full in both 'Error Severity Levels' and 'Common Error Types', and the closing Summary restates prior sections. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 2 because most content is domain-specific reference material, not concepts Claude already knows.

3 / 5

Actionability

Each common error type pairs a concrete error payload with a copy-paste fix (e.g. `config.channel = "#general"`, `config.limit = 100`, `config.text = "={{$json.name}}"`), and recovery strategies show exact tool invocations like `n8n_update_partial_workflow({ id, operations: [{ type: "cleanStaleConnections" }] })`. It falls short of anchor 5 only through minor gaps: `get_node` is cited four times as a key step but never shown, and the referenced ERROR_CATALOG.md / FALSE_POSITIVES.md files do not exist in the bundle.

4 / 5

Workflow Clarity

The core multi-step process is explicitly sequenced with a validation feedback loop ("Validate → Read errors → Fix → Validate again; Repeat until valid"), recovery strategies branch by failure mode, and the auto-fix flow embeds a verification checkpoint ("applyFixes: false // Preview first", then apply). This matches anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery; checklists'), reinforced by the Do/Don't checklist.

5 / 5

Progressive Disclosure

Section headers are clear and consistent throughout, but the 'Detailed Guides' section points to ERROR_CATALOG.md and FALSE_POSITIVES.md, which do not exist in any bundle directory (no references/, scripts/, or assets/), and ~690 lines of catalog-level detail (error types, false-positive cases) are inlined in SKILL.md rather than split into those files. This fits anchor 3 ('content that should be separate is inline'); it is not anchor 2 because the internal structure is extensive and easy to navigate, not minimal.

3 / 5

Total

15

/

20

Passed

Description

53%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.

The description is concise and names a distinct niche with a clear 'what', but it reads as a topic label rather than a trigger: it has no 'Use when...' guidance and very few natural trigger phrases beyond "n8n validation errors". Adding explicit usage triggers and one or two more capability keywords would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when an n8n node or workflow fails validation, returns validation errors, or won't activate due to invalid configuration."

Name a few concrete capabilities to improve specificity and keywords, e.g. "Reads validation error types (missing_required, invalid_value, type_mismatch), picks validation profiles, and fixes operator/connection issues."

Disambiguate from sibling skills (e.g. n8n Expression Syntax) by scoping the description to node/workflow validation rather than expression authoring.

DimensionReasoningScore

Specificity

The description names the domain ("n8n validation errors") and two concrete actions ("interpreting and fixing"), but lists no further specific capabilities. This matches anchor 3 ('Names domain and 1-2 concrete actions, but not comprehensive') — it is not anchor 4 because it does not enumerate several specific actions like reading error codes, choosing validation profiles, or resolving broken connections.

3 / 5

Completeness

The 'what' is clear (interpreting and fixing n8n validation errors), but there is no 'Use when...' clause or equivalent trigger guidance — the 'when' is only weakly implied by the topic itself. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; it is not anchor 4 because no explicit usage trigger exists at all.

3 / 5

Trigger Term Quality

"n8n" and "validation errors" are the natural core phrases a user would say, but common variations are absent — no mention of "node configuration", "workflow won't activate", "invalid configuration", or specific error terms. This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms'); it is not anchor 4 because keyword coverage is limited to essentially two terms.

3 / 5

Distinctiveness Conflict Risk

"n8n validation errors" carves out a clear niche (the n8n platform's validation system) and would rarely trigger for unrelated skills. It is not anchor 5 because the description does not distinguish it from closely related n8n skills the body itself references (e.g., "n8n Expression Syntax", which also covers invalid_expression errors), leaving minor overlap risk.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (692 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/n8n-validation-expert/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.