All skills
czlonkowski avatar

/n8n-expression-syntax

@b604bea

Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors, mapping data between nodes, or referencing webhook data in workflows. Use this skill whenever configuring node fields that reference data from previous nodes — expressions are how n8n passes data between nodes, and getting the syntax wrong is the most common source of workflow errors. Also use when asked whether a complex expression hurts performance.

Use this Skill: https://skilld.dev/gh/czlonkowski/n8n-mcp/n8n-expression-syntax

This session only. Nothing lands on disk.

README.md

≈568 tokens on demand. Your agent reads this file only when SKILL.md points to it.

n8n Expression Syntax

Expert guide for writing correct n8n expressions in workflows.


Purpose

Teaches correct n8n expression syntax ({{ }} patterns) and fixes common mistakes, especially the critical webhook data structure gotcha.

Activates On

  • expression
  • {{}} syntax
  • $json, $node, $now, $env
  • webhook data
  • troubleshoot expression error
  • undefined in workflow

File Count

4 files

Dependencies

n8n-mcp tools:

  • None directly (syntax knowledge skill)
  • Works with n8n-mcp validation tools

Related skills:

  • n8n Workflow Patterns (uses expressions in examples)
  • n8n MCP Tools Expert (validates expressions)
  • n8n Node Configuration (when expressions are needed)

Coverage

Core Topics

  • Expression format ({{ }})
  • Core variables ($json, $node, $now, $env)
  • Webhook data structure ($json.body.*)
  • When NOT to use expressions (Code nodes)

Common Patterns

  • Accessing nested fields
  • Referencing other nodes
  • Array and object access
  • Date/time formatting
  • String manipulation

Error Prevention

  • 15 common mistakes with fixes
  • Quick reference table
  • Debugging process

Evaluations

4 scenarios (100% coverage expected):

  1. eval-001: Missing curly braces
  2. eval-002: Webhook body data access (critical!)
  3. eval-003: Code node vs expression confusion
  4. eval-004: Node reference syntax

Key Features

✅ Critical Gotcha Highlighted: Webhook data under .body ✅ Real Examples: From MCP testing and real templates ✅ Quick Fixes Table: Fast reference for common errors ✅ Code vs Expression: Clear distinction ✅ Comprehensive: Covers 95% of expression use cases

Files

  • SKILL.md - Main content with all essential knowledge
  • COMMON_MISTAKES.md - Complete error catalog with 15 common mistakes
  • EXAMPLES.md - 10 real working examples
  • README.md (this file) - Skill metadata

Success Metrics

Expected outcomes:

  • Users correctly wrap expressions in {{ }}
  • Zero webhook .body access errors
  • No expressions used in Code nodes
  • Correct $node reference syntax

Last Updated

2025-10-20


Part of: n8n-skills repository Conceived by: Romuald Członkowski - www.aiadvisors.pl/en

Source: SKILL.md on GitHub

No alerts12d3 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    The skill is a comprehensive educational guide for n8n expression syntax, covering data access, common errors, and performance optimization. It teaches safe practices such as using credentials instead of environment variables. While it documents how to process untrusted webhook data and use dynamic execution features like IIFEs, these are core platform functions and are presented in an educational context with appropriate guidance.

  • Socket12d

    No alerts

  • Snyk12d

    Risk: LOW · No issues

Signed by skilld at b604bea. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 3 months ago

README badge

README badge for czlonkowski/n8n-mcp/n8n-expression-syntax