ros/n8n-skills
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-skills.git synced 2026-03-16 23:43:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
bf9e1b46a320c8697d112d801ca9a14b1fa4f46b
n8n-skills/skills/n8n-mcp-tools-expert/README.md
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

2.9 KiB
Raw Blame History

n8n MCP Tools Expert

Expert guide for using n8n-mcp MCP tools effectively.

Purpose

Teaches how to use n8n-mcp MCP server tools correctly for efficient workflow building.

Activates On

  • search nodes
  • find node
  • validate
  • MCP tools
  • template
  • workflow
  • n8n-mcp
  • tool selection

File Count

5 files, ~1,150 lines total

Priority

HIGHEST - Fixes 20% MCP tool failure rate

Dependencies

n8n-mcp tools: All of them! (40+ tools)

Related skills:

  • n8n Expression Syntax (write expressions for workflows)
  • n8n Workflow Patterns (use tools to build patterns)
  • n8n Validation Expert (interpret validation results)
  • n8n Node Configuration (configure nodes found with tools)

Coverage

Core Topics

  • Tool selection guide (which tool for which task)
  • nodeType format differences (nodes-base.* vs n8n-nodes-base.*)
  • Validation profiles (minimal/runtime/ai-friendly/strict)
  • Smart parameters (branch, case for multi-output nodes)
  • Auto-sanitization system
  • Workflow management (15 operation types)
  • AI connection types (8 types)

Tool Categories

  • Node Discovery (search, list, essentials, info)
  • Configuration Validation (minimal, operation, workflow)
  • Workflow Management (create, update, validate)
  • Template Library (search, get)
  • Documentation (tools, database stats)

Evaluations

5 scenarios (100% coverage expected):

  1. eval-001: Tool selection (search_nodes)
  2. eval-002: nodeType format (nodes-base.* prefix)
  3. eval-003: Validation workflow (profiles)
  4. eval-004: essentials vs info (5KB vs 100KB)
  5. eval-005: Smart parameters (branch, case)

Key Features

✅ Data-Driven: Based on 447,557 real MCP tool events ✅ Telemetry Insights: Actual usage patterns (56s between edits, 18s between search/essentials) ✅ Critical Mistakes: Highlights 20% failure rate issues ✅ Smart Parameters: Teaches semantic branch/case routing ✅ Auto-Sanitization: Explains automatic fixes ✅ Comprehensive: Covers all 40+ tools

Files

  • SKILL.md (480 lines) - Core tool usage guide
  • SEARCH_GUIDE.md (220 lines) - Node discovery tools
  • VALIDATION_GUIDE.md (250 lines) - Validation tools and profiles
  • WORKFLOW_GUIDE.md (200 lines) - Workflow management
  • README.md (this file) - Skill metadata

Success Metrics

Expected outcomes:

  • Correct nodeType formats (nodes-base.* for search)
  • get_node_essentials preferred over get_node_info
  • Validation profiles used correctly
  • Smart parameters for IF/Switch nodes
  • 20% failure rate reduced to <5%

Critical Insights

From MCP Testing Log:

  • search → essentials: 9,835 occurrences, 18s avg
  • validate → fix: 7,841 loops, 23s thinking, 58s fixing
  • update_partial: 38,287 uses, 56s between edits
  • get_node_info: 20% failure rate (use essentials!)

Last Updated

2025-10-20

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