mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 23:43:08 +00:00
f7d34f2b8e
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
26 lines
1.1 KiB
JSON
26 lines
1.1 KiB
JSON
{
|
|
"id": "mcp-005",
|
|
"skills": ["n8n-mcp-tools-expert"],
|
|
"query": "I'm using n8n_update_partial_workflow to connect an IF node to two different handlers. How do I specify which branch (true or false) each connection should use?",
|
|
"expected_behavior": [
|
|
"Explains smart parameters for multi-output nodes",
|
|
"Shows branch parameter: branch='true' or branch='false'",
|
|
"Provides complete example with addConnection operation",
|
|
"Explains this is simpler than using sourceIndex manually",
|
|
"Mentions Switch nodes use case=N parameter",
|
|
"References WORKFLOW_GUIDE.md for more details",
|
|
"Shows both true and false branch connections"
|
|
],
|
|
"baseline_without_skill": {
|
|
"likely_response": "May suggest using output indices without knowing semantic parameters exist",
|
|
"expected_quality": "Medium - might work but miss the easier smart parameter approach"
|
|
},
|
|
"with_skill_expected": {
|
|
"response_quality": "High - teaches smart parameters for cleaner code",
|
|
"uses_skill_content": true,
|
|
"shows_branch_parameter": true,
|
|
"provides_working_example": true,
|
|
"mentions_switch_equivalent": true
|
|
}
|
|
}
|