CtrlK
BlogDocsLog inGet started
Tessl Logo

n8n-validation-expert

Interpret validation errors and guide fixing them. Use when encountering validation errors, validation warnings, false positives, operator structure issues, or need help understanding validation results. Also use when asking about validation profiles, error types, the validation loop process, or auto-fix capabilities. Consult this skill whenever a validate_node or validate_workflow call returns errors or warnings — it knows which warnings are false positives and which errors need real fixes.

59

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/n8n-validation-expert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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

This is a strong skill description with excellent trigger term coverage and completeness, clearly specifying both what the skill does and when to use it with multiple explicit trigger clauses. The main weakness is that the 'what' portion could be more specific about concrete actions beyond 'interpret' and 'guide fixing' — for example, listing specific fix types or validation operations it can perform. Overall, it would perform well in a multi-skill selection scenario.

Suggestions

Strengthen specificity by listing more concrete actions, e.g., 'Identifies false positive warnings, suggests fixes for operator structure issues, explains error codes, and guides the validation loop process' instead of the vaguer 'interpret validation errors and guide fixing them'.

DimensionReasoningScore

Specificity

The description names the domain (validation errors) and some actions ('interpret validation errors', 'guide fixing them'), but doesn't list multiple concrete specific actions. Terms like 'guide fixing' and 'help understanding' are somewhat vague rather than describing precise operations.

2 / 3

Completeness

Clearly answers both 'what' (interpret validation errors and guide fixing them) and 'when' with explicit triggers ('Use when encountering validation errors...', 'Also use when asking about...', 'Consult this skill whenever a validate_node or validate_workflow call returns errors or warnings'). Multiple explicit 'Use when' clauses are provided.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'validation errors', 'validation warnings', 'false positives', 'operator structure issues', 'validation results', 'validation profiles', 'error types', 'validation loop process', 'auto-fix capabilities', 'validate_node', 'validate_workflow'. These cover both user-facing language and technical API terms users would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around validation errors, validation workflows, and specific API calls (validate_node, validate_workflow). The mention of false positives, validation profiles, and auto-fix capabilities further narrows the scope, making it unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

47%

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

This skill has strong workflow clarity with a well-defined validate-fix-validate loop and good recovery strategies, but is severely undermined by verbosity. It repeats key concepts multiple times, explains things Claude already knows (how to read JSON, what false positives are, how to iterate arrays), and inlines detailed reference material that should live in the referenced ERROR_CATALOG.md and FALSE_POSITIVES.md files. Trimming this to ~40% of its current size while pushing details to bundle files would dramatically improve it.

Suggestions

Cut content by 50-60%: remove the 'How to Read It' section, telemetry statistics, repeated 'validation is iterative' statements, and explanations of basic concepts like what false positives are.

Move the detailed error type catalog (missing_required, invalid_value, type_mismatch, etc.) into ERROR_CATALOG.md and keep only a brief summary table in SKILL.md.

Move the false positives section into FALSE_POSITIVES.md (which is already referenced) instead of duplicating the content inline.

Consolidate the auto-sanitization and auto-fix sections — they overlap conceptually and could be a single concise section with a reference to a detailed guide.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Includes extensive explanations Claude doesn't need (what false positives are, how to read JSON results, basic iteration concepts). The telemetry statistics (7,841 occurrences, 23s/58s timings) are unnecessary filler. Many sections repeat the same concepts (validation is iterative is stated 4+ times). The 'How to Read It' section explaining how to check a boolean field and iterate over arrays is insulting to Claude's intelligence.

1 / 3

Actionability

Provides concrete code examples for error types and fixes, and specific tool invocations (validate_node, n8n_autofix_workflow). However, many examples are illustrative rather than truly executable in context — they show conceptual JavaScript snippets rather than actual MCP tool call patterns. The fix guidance for each error type is concrete and useful, but the recovery strategies mix actionable steps with vague advice.

2 / 3

Workflow Clarity

The validation loop is clearly sequenced with explicit validate → read → fix → re-validate cycles. Recovery strategies are well-organized with clear 'when to use' criteria. The auto-fix workflow includes a preview-then-apply pattern with confidence thresholds. The iterative feedback loop is the core of this skill and it's well-articulated with validation checkpoints.

3 / 3

Progressive Disclosure

References ERROR_CATALOG.md and FALSE_POSITIVES.md at the end, which is good progressive disclosure. However, the SKILL.md itself contains enormous amounts of detail that should be in those referenced files — the full false positives section, the complete common error types catalog, and the auto-sanitization details could all be offloaded. The main file tries to be both overview and comprehensive reference.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

10

/

11

Passed

Repository
czlonkowski/n8n-skills
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.