Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A rich, highly actionable n8n expression reference with concrete examples, a strong transform decision process, and valuable debugging/performance guidance. Its main weaknesses are repeated restatement of the same core rules across sections and dangling links to bundle files (COMMON_MISTAKES.md, EXAMPLES.md) that are not present.
Suggestions
Consolidate the rules repeated across Expression Format, Validation Rules, Common Mistakes, Best Practices, and Summary ({{}} wrapping, webhook .body, no expressions in Code nodes) into one canonical section and cross-reference it instead of restating.
Create the referenced COMMON_MISTAKES.md and EXAMPLES.md files (or remove the dangling links) so progressive-disclosure references actually resolve.
Move the full error catalog and extended worked examples into those referenced files, keeping SKILL.md a lean overview with key inline snippets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~650 lines and restates the same rules across multiple sections — {{}} wrapping appears in Expression Format, Validation Rules, Common Mistakes, Best Practices, and Summary; webhook .body and Code-node-no-expression recur similarly — so it is mostly valuable n8n-specific content but could be tightened; not a 2 because most material is non-obvious domain knowledge rather than concepts Claude already knows. | 3 / 5 |
Actionability | Abundant copy-paste-ready expressions with ✅/❌ pairs, a concrete IIFE-in-Edit-Fields pattern, and a precise $jmespath quoting table covering the common cases with executable syntax. | 5 / 5 |
Workflow Clarity | The transform gatekeeper (expression → IIFE → Code node) is a clearly ordered decision process with rationale, and the debugging section has a real feedback loop (test → inspect output for null → wrap to surface the real error); not a 5 because some validation checkpoints are implicit rather than enumerated as a checklist. | 4 / 5 |
Progressive Disclosure | Section headers give reasonable structure and references to COMMON_MISTAKES.md and EXAMPLES.md are clearly signaled as links, but neither file exists in the bundle, so the references are dangling against a 650-line monolithic body; not a 4 because the broken offload undermines the intended split. | 3 / 5 |
Total | 15 / 20 Passed |