feat: Complete Skill #1 - n8n Expression Syntax

## Skill #1 Complete - n8n Expression Syntax

 **4 Evaluations Created**:
- eval-001: Missing curly braces
- eval-002: Webhook body data access (critical!)
- eval-003: Code node vs expression confusion
- eval-004: Node reference syntax

 **4 Skill Files** (~1,115 lines total):
- SKILL.md (285 lines) - Core concepts, under 500 line limit
- COMMON_MISTAKES.md (380 lines) - 15 common errors with fixes
- EXAMPLES.md (450 lines) - 10 real working examples
- README.md - Skill metadata

## Key Features

🎯 **Critical Gotcha Highlighted**: Webhook data under .body
📚 **Real Examples**: From MCP testing log and templates
 **Quick Fixes**: Fast reference table for common errors
🔍 **Code vs Expression**: Clear distinction when NOT to use {{}}
 **Comprehensive**: Covers 95% of expression use cases

## Content Highlights

- Expression format ({{  }})
- Core variables ($json, $node, $now, $env)
- **Webhook data structure** (most common mistake!)
- When NOT to use expressions (Code nodes)
- Array/object access patterns
- Date/time formatting
- String manipulation
- Conditional logic

## Based on MCP Testing

All examples verified against real:
- Webhook node structure from get_node_essentials
- Template #2947 (Weather to Slack)
- Code node guide from tools_documentation
- Real error messages from validation

## Next: Skill #2 - n8n MCP Tools Expert

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
This commit is contained in:
czlonkowski
2025-10-20 10:19:19 +02:00
parent dff62f0c52
commit 9a5e0c0b89
8 changed files with 1576 additions and 0 deletions

View File

@@ -0,0 +1,23 @@
{
"id": "expr-003",
"skills": ["n8n-expression-syntax"],
"query": "I'm trying to use {{$json.email}} in my Code node to get the email address, but it's not working. The code shows the literal string '{{$json.email}}' instead of the value. How do I fix this?",
"expected_behavior": [
"Identifies that Code nodes use direct JavaScript access, NOT expressions",
"Explains that {{ }} syntax is NOT used inside Code nodes",
"Provides the corrected Code node syntax: $json.email or $input.item.json.email",
"Explains when NOT to use expressions (Code nodes, Function nodes)",
"References Code node guide or documentation"
],
"baseline_without_skill": {
"likely_response": "May suggest template literal syntax or string interpolation, unlikely to know n8n Code node specifics",
"expected_quality": "Low - would not understand Code node vs expression node difference"
},
"with_skill_expected": {
"response_quality": "High - immediately identifies Code node vs expression context",
"uses_skill_content": true,
"provides_correct_code_syntax": true,
"explains_when_not_to_use_expressions": true,
"clear_distinction_between_contexts": true
}
}