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
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/n8n-validation-expert/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (762 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
27e9d0a
Table of Contents
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.