mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 23:43:08 +00:00
docs: Remove telemetry and research context from user-facing documentation
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
This commit is contained in:
czlonkowski
56
README.md
56
README.md
@@ -3,21 +3,21 @@
|
||||
**Expert Claude Code skills for building flawless n8n workflows using the n8n-mcp MCP server**
|
||||
|
||||
[](LICENSE)
|
||||
[](https://github.com/romualdczlonkowski/n8n-mcp)
|
||||
[](https://github.com/czlonkowski/n8n-mcp)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 What is this?
|
||||
|
||||
This repository contains 5 complementary **Claude Code skills** that teach AI assistants how to build production-ready n8n workflows using the [n8n-mcp](https://github.com/your-link-here) MCP server.
|
||||
This repository contains 5 complementary **Claude Code skills** that teach AI assistants how to build production-ready n8n workflows using the [n8n-mcp](https://github.com/czlonkowski/n8n-mcp) MCP server.
|
||||
|
||||
### Why These Skills Exist
|
||||
|
||||
Based on analysis of **447,557 real MCP tool usage events**, we identified:
|
||||
- **20% failure rate** when using certain MCP tools incorrectly
|
||||
- **15,107 validation feedback loops** due to configuration errors
|
||||
- **813 searches for "webhook"** showing common workflow patterns
|
||||
- **31,917 workflows created** revealing proven architectural patterns
|
||||
Building n8n workflows programmatically can be challenging. Common issues include:
|
||||
- Using MCP tools incorrectly or inefficiently
|
||||
- Getting stuck in validation error loops
|
||||
- Not knowing which workflow patterns to use
|
||||
- Misconfiguring nodes and their dependencies
|
||||
|
||||
These skills solve these problems by teaching Claude:
|
||||
- ✅ Correct n8n expression syntax ({{}} patterns)
|
||||
@@ -53,22 +53,20 @@ Expert guide for using n8n-mcp MCP tools effectively.
|
||||
- Smart parameters (branch="true" for IF nodes)
|
||||
- Auto-sanitization system explained
|
||||
|
||||
**Impact**: **Fixes 20% MCP tool failure rate**
|
||||
**Most Important**: Teaches correct MCP tool usage patterns and parameter formats
|
||||
|
||||
### 3. **n8n Workflow Patterns**
|
||||
Build workflows using 5 proven architectural patterns from 31,917 real workflows.
|
||||
Build workflows using 5 proven architectural patterns.
|
||||
|
||||
**Activates when**: Creating workflows, connecting nodes, designing automation.
|
||||
|
||||
**Key Features**:
|
||||
- 5 proven patterns (webhook processing, HTTP API, database, AI, scheduled)
|
||||
- Workflow creation checklist
|
||||
- Real examples from 2,653 templates
|
||||
- Real examples from 2,653+ n8n templates
|
||||
- Connection best practices
|
||||
- Pattern selection guide
|
||||
|
||||
**Impact**: **Addresses 27.6% of all workflows (webhook processing)**
|
||||
|
||||
### 4. **n8n Validation Expert**
|
||||
Interpret validation errors and guide fixing.
|
||||
|
||||
@@ -98,7 +96,7 @@ Operation-aware node configuration guidance.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. **n8n-mcp MCP server** installed and configured ([Installation Guide](https://github.com/romualdczlonkowski/n8n-mcp))
|
||||
1. **n8n-mcp MCP server** installed and configured ([Installation Guide](https://github.com/czlonkowski/n8n-mcp))
|
||||
2. **Claude Code**, Claude.ai, or Claude API access
|
||||
3. `.mcp.json` configured with n8n-mcp server
|
||||
|
||||
@@ -171,22 +169,6 @@ All 5 skills compose seamlessly!
|
||||
|
||||
---
|
||||
|
||||
## 🔬 Data-Driven Design
|
||||
|
||||
These skills are based on telemetry analysis of:
|
||||
- **447,557** MCP tool usage events
|
||||
- **31,917** workflows created
|
||||
- **19,113** validation errors
|
||||
- **15,107** validation feedback loops
|
||||
- **2,653** workflow templates
|
||||
|
||||
Key insights:
|
||||
- `search_nodes → get_node_essentials` is the most common pattern (9,835 occurrences, 18s avg)
|
||||
- `n8n_update_partial_workflow` is the most-used tool (38,287 uses, 99.0% success)
|
||||
- Validation loops average 23s thinking, 58s fixing
|
||||
- Webhook workflows represent 27.6% of all workflows (813 searches)
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Testing
|
||||
|
||||
@@ -226,25 +208,23 @@ MIT License - see [LICENSE](LICENSE) file for details.
|
||||
|
||||
**Conceived by Romuald Członkowski**
|
||||
- Website: [www.aiadvisors.pl/en](https://www.aiadvisors.pl/en)
|
||||
- Part of the [n8n-mcp project](https://github.com/romualdczlonkowski/n8n-mcp)
|
||||
- Part of the [n8n-mcp project](https://github.com/czlonkowski/n8n-mcp)
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Related Projects
|
||||
|
||||
- [n8n-mcp](https://github.com/romualdczlonkowski/n8n-mcp) - MCP server for n8n
|
||||
- [n8n-mcp](https://github.com/czlonkowski/n8n-mcp) - MCP server for n8n
|
||||
- [n8n](https://n8n.io/) - Workflow automation platform
|
||||
|
||||
---
|
||||
|
||||
## 📊 Repository Stats
|
||||
## 📊 What's Included
|
||||
|
||||
- **5** complementary skills
|
||||
- **~3,220** lines of skill content
|
||||
- **15-20** evaluation scenarios
|
||||
- **88%** documentation coverage (from n8n-mcp)
|
||||
- **537** nodes supported
|
||||
- **2,653** templates available
|
||||
- **5** complementary skills that work together
|
||||
- **525+** n8n nodes supported
|
||||
- **2,653+** workflow templates for examples
|
||||
- **Comprehensive** error catalogs and troubleshooting guides
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user