czlonkowski
651467dee6
feat: Complete Skill #3 - n8n Workflow Patterns
...
Implements comprehensive workflow pattern guidance from 31,917 real workflows.
Addresses the most common use case (813 webhook searches).
Files created:
- 5 evaluations testing pattern selection and implementation
- SKILL.md (486 lines) - Pattern overview, selection guide, workflow checklist
- webhook_processing.md (554 lines) - Webhook patterns, $json.body gotcha, auth
- http_api_integration.md (763 lines) - REST APIs, pagination, rate limiting
- database_operations.md (854 lines) - DB ops, batch processing, SQL injection prevention
- ai_agent_workflow.md (918 lines) - AI agents, 8 connection types, tool configuration
- scheduled_tasks.md (845 lines) - Cron schedules, timezone handling, monitoring
- README.md - Skill metadata with pattern statistics
Key features:
- 5 core patterns: Webhook (35%), HTTP API (892 templates), Database (456), AI (234), Scheduled (28%)
- Workflow creation checklist (planning → implementation → validation → deployment)
- Pattern selection guide with statistics
- Common gotchas documented (webhook $json.body, SQL injection, timezone, etc.)
- Error handling strategies for each pattern
- Performance optimization techniques
- Security best practices
- Testing approaches
- Real template examples
Critical insights:
- Webhook data under $json.body (not $json) - #1 gotcha
- Always use parameterized queries (SQL injection prevention)
- ANY node can be an AI tool (connect to ai_tool port)
- Set workflow timezone explicitly (DST handling)
- Authentication via credentials (never hardcode)
Pattern statistics:
- Trigger distribution: Webhook 35%, Schedule 28%, Manual 22%, Service 15%
- Transformation: Set 68%, Code 42%, IF 38%, Switch 18%
- Output: HTTP 45%, Slack 32%, Database 28%, Email 24%
- Complexity: Simple 42%, Medium 38%, Complex 20%
Total: ~4,420 lines across 12 files
Based on analysis of 31,917 real workflows and usage patterns.
🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 10:38:38 +02:00
czlonkowski
f7d34f2b8e
feat: Complete Skill #2 - n8n MCP Tools Expert
...
Implements comprehensive guidance for using n8n-mcp MCP tools effectively.
This is the HIGHEST PRIORITY skill that addresses the 20% MCP tool failure rate.
Files created:
- 5 evaluations testing tool selection, nodeType formats, validation, and smart parameters
- SKILL.md (505 lines) - Core tool usage guide with telemetry insights
- SEARCH_GUIDE.md (243 lines) - Node discovery tools (search, essentials vs info)
- VALIDATION_GUIDE.md (377 lines) - Configuration validation and auto-sanitization
- WORKFLOW_GUIDE.md (385 lines) - Workflow management with 15 operation types
- README.md - Skill metadata emphasizing highest priority
Key features:
- Tool selection guide with success rates (search_nodes 99.9%, get_node_essentials 91.7%)
- nodeType format distinction (nodes-base.* vs n8n-nodes-base.*)
- Validation profiles explained (minimal/runtime/ai-friendly/strict)
- Smart parameters for IF/Switch nodes (branch="true", case=0)
- Auto-sanitization system for operator structures
- Telemetry insights (56s between edits, 18s search→essentials, 23s+58s validate→fix)
- AI connection types (8 types documented)
Total: ~1,650 lines across 10 files
Based on analysis of 447,557 real MCP tool usage events.
🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 10:26:40 +02:00
czlonkowski
9a5e0c0b89
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
2025-10-20 10:19:19 +02:00
czlonkowski
dff62f0c52
feat: Complete Phase 1 - Foundation and Documentation
...
## Phase 1 Achievements
✅ Repository Structure:
- Created complete directory structure (skills/, evaluations/)
- Updated .gitignore (removed docs/, keep .mcp.json)
✅ MCP Testing:
- Verified n8n API availability (https://n8n-test.n8n-mcp.com )
- Tested MCP tools comprehensively
- Created MCP_TESTING_LOG.md with real tool responses
✅ Documentation:
- README.md: Comprehensive project overview with data-driven insights
- INSTALLATION.md: Complete installation guide for all platforms
- USAGE.md: Detailed usage examples and cross-skill composition
- DEVELOPMENT.md: Development guidelines and contribution process
## Key Insights from MCP Testing
- 537 nodes available (437 base + 100 langchain)
- 2,653 templates with metadata
- nodeType format differences documented
- Webhook data structure clarified ($json.body)
- Auto-sanitization behavior documented
- All n8n_* tools require API; all others don't
## Next: Phase 2 - Skill #1 (n8n Expression Syntax)
🤖 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
2025-10-20 10:14:34 +02:00
