Content
50%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides solid, actionable reference material for n8n expression syntax with good correct/incorrect examples and realistic scenarios. However, it is significantly bloated by repetition (webhook .body access, {{}} rules, and Code node warnings are each stated 3-4 times) and by including reference material Claude already knows (JavaScript string/array methods). The content would benefit from aggressive deduplication and splitting detailed reference material into bundle files.
Suggestions
Eliminate redundancy: the webhook .body rule, {{}} requirement, and Code node warning each appear 3-4 times — state each once in a dedicated section and remove duplicates from Summary, Best Practices, Validation Rules, and Common Mistakes.
Remove the 'Expression Helpers' section listing standard JavaScript methods (toLowerCase, map, filter, etc.) — Claude already knows these.
Move 'Data Type Handling', 'Advanced Patterns', and 'Expression Helpers' into a separate REFERENCE.md bundle file to keep SKILL.md as a concise overview.
Add an explicit validation workflow: describe how to actually validate expressions using the MCP tools mentioned in the description, with a check → fix → re-check loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is significantly verbose at ~350+ lines. It repeats the same concepts multiple times (webhook .body access is explained at least 4 separate times, the {{}} rule is stated repeatedly, Code node warnings appear multiple times). The Summary section largely restates what was already covered. The 'Expression Helpers' section lists standard JavaScript methods Claude already knows. The 'Best Practices' section is entirely redundant with prior content. | 2 / 5 |
Actionability | The skill provides concrete, executable expression syntax with clear correct/incorrect examples throughout. The working examples with realistic JSON payloads are particularly useful. Minor gap: no actual validation commands or tool invocations are shown despite the skill description mentioning 'validate n8n expression syntax' — the debugging section is vague ('click fx icon'). | 4 / 5 |
Workflow Clarity | This is primarily a reference/syntax skill rather than a multi-step workflow, so the bar is lower. However, the skill description says 'Validate n8n expression syntax and fix common errors' which implies a validation workflow. The debugging section provides a rough sequence (open editor → check preview → look for errors) but lacks explicit validation checkpoints or a fix-and-retry loop. For a skill focused on validation and fixing, this is a gap. | 3 / 5 |
Progressive Disclosure | References to COMMON_MISTAKES.md and EXAMPLES.md are appropriate and clearly signaled, but no bundle files are provided so these references are unverifiable. The main file itself contains too much content that could be split out — the Expression Helpers section, Data Type Handling, and Advanced Patterns would be better as separate reference files. The inline content is too long for an overview document. | 3 / 5 |
Total | 12 / 20 Passed |