mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 23:43:08 +00:00
e19ea6ea8d
Clean up all README files to focus on user value rather than research metrics. Remove telemetry numbers and research context that isn't useful for end users. ## Changes **Main README.md**: - Removed "Based on 447,557 real MCP tool usage events" section - Replaced failure rate metrics with user benefits - Removed entire "Data-Driven Design" section with telemetry statistics - Fixed all GitHub links to use czlonkowski/n8n-mcp - Updated "Repository Stats" to "What's Included" with user-focused content **dist/README.md**: - Changed "HIGHEST PRIORITY" to "recommended to install first" - Added link to n8n-mcp repository - More user-friendly language throughout **Skill README.md files**: - n8n-mcp-tools-expert: Removed "447,557 events", "20% failure rate" metrics - n8n-workflow-patterns: Removed "Based on 31,917 real workflows" - n8n-validation-expert: Removed "From 7,841 validate → fix cycles" - Replaced frequency percentages with priority levels (Highest/High/Medium/Low) - Reframed "Success Metrics" as "What You'll Learn" - Changed "Critical Insights from telemetry" to "Key Insights" for users ## Kept What Matters - Template counts (2,653+) - this is a feature, not research - Node counts (525+) - this is a feature - Practical insights (validation takes 2-3 iterations, false positives exist) - Best practices and common patterns ## Result Documentation now focuses on what users need to know to use the skills effectively, rather than the research that informed their creation. All distribution packages regenerated with cleaned documentation. 🤖 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
100 lines
2.7 KiB
Markdown
100 lines
2.7 KiB
Markdown
# 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** - Essential for correct MCP tool usage
|
|
|
|
## 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
|
|
|
|
✅ **Tool Selection Guide**: Which tool to use for each task
|
|
✅ **Common Patterns**: Most effective tool usage sequences
|
|
✅ **Format Guidance**: nodeType format differences explained
|
|
✅ **Smart Parameters**: Semantic branch/case routing for multi-output nodes
|
|
✅ **Auto-Sanitization**: Explains automatic validation fixes
|
|
✅ **Comprehensive**: Covers all 40+ MCP 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
|
|
|
|
## What You'll Learn
|
|
|
|
- Correct nodeType formats (nodes-base.* for search tools)
|
|
- When to use get_node_essentials vs get_node_info
|
|
- How to use validation profiles effectively
|
|
- Smart parameters for multi-output nodes (IF/Switch)
|
|
- Common tool usage patterns and workflows
|
|
|
|
## Last Updated
|
|
|
|
2025-10-20
|
|
|
|
---
|
|
|
|
**Part of**: n8n-skills repository
|
|
**Conceived by**: Romuald Członkowski - [www.aiadvisors.pl/en](https://www.aiadvisors.pl/en)
|