2 Commits

Author	SHA1	Message	Date
czlonkowski	33e83c29dc	refactor: Remove research context from skill content ... Cleaned up all skills to remove research/telemetry context that was used during design but is not needed at runtime when AI agents use the skills. ## Changes Made ### Pattern 1: Research Framing Removed - "From analysis of X workflows/events" → Removed - "From telemetry analysis:" → Replaced with operational context - "Based on X real workflows" → Simplified to general statements ### Pattern 2: Popularity Metrics Removed - "**Popularity**: Second most common (892 templates)" → Removed entirely - "813 searches", "456 templates", etc. → Removed ### Pattern 3: Frequency Percentages Converted - "**Frequency**: 45% of errors" → "Most common error" - "**Frequency**: 28%" → "Second most common" - "**Frequency**: 12%" → "Common error" - Percentages in tables → Priority levels (Highest/High/Medium/Low) ### Pattern 4: Operational Guidance Kept - ✅ Success rates (91.7%) - helps tool selection - ✅ Average times (18s, 56s) - sets expectations - ✅ Relative priority (most common, typical) - guides decisions - ✅ Iteration counts (2-3 cycles) - manages expectations ## Files Modified (19 files across 4 skills) **Skill #2: MCP Tools Expert (5 files)** - Removed telemetry occurrence counts - Kept success rates and average times **Skill #3: Workflow Patterns (7 files)** - Removed all popularity metrics from pattern files - Removed "From analysis of 31,917 workflows" - Removed template counts **Skill #4: Validation Expert (4 files)** - Converted frequency % to priority levels - Removed "From analysis of 19,113 errors" - Removed telemetry loop counts (kept iteration guidance) **Skill #5: Node Configuration (3 files)** - Removed workflow update counts - Removed essentials call counts - Kept success rates and timing guidance ## Result Skills now provide clean, focused runtime guidance without research justification. Content is more actionable for AI agents using the skills. All technical guidance, examples, patterns, and operational metrics preserved. Only removed: research methodology, data source attribution, and statistical justification for design decisions. 🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en	2025-10-20 11:45:04 +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