mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-04-05 00:53: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:
@@ -94,39 +94,27 @@ n8n-validation-expert/
|
||||
|
||||
**Total**: ~2,224 lines across 4 files
|
||||
|
||||
## Error Distribution
|
||||
## Common Error Types
|
||||
|
||||
Based on 19,113 validation errors:
|
||||
|
||||
| Error Type | Frequency | Auto-Fix | Severity |
|
||||
| Error Type | Priority | Auto-Fix | Severity |
|
||||
|---|---|---|---|
|
||||
| missing_required | 45% | ❌ | Error |
|
||||
| invalid_value | 28% | ❌ | Error |
|
||||
| type_mismatch | 12% | ❌ | Error |
|
||||
| invalid_expression | 8% | ❌ | Error |
|
||||
| invalid_reference | 5% | ❌ | Error |
|
||||
| operator_structure | 2% | ✅ | Warning |
|
||||
|
||||
## Validation Loop Statistics
|
||||
|
||||
From 7,841 validate → fix cycles:
|
||||
|
||||
- **Average thinking time**: 23 seconds
|
||||
- **Average fix time**: 58 seconds
|
||||
- **Total cycle time**: 81 seconds average
|
||||
- **Iterations to success**: 2-3 average
|
||||
- **Success rate after 3 iterations**: 94%
|
||||
| missing_required | Highest | ❌ | Error |
|
||||
| invalid_value | High | ❌ | Error |
|
||||
| type_mismatch | Medium | ❌ | Error |
|
||||
| invalid_expression | Medium | ❌ | Error |
|
||||
| invalid_reference | Low | ❌ | Error |
|
||||
| operator_structure | Low | ✅ | Warning |
|
||||
|
||||
## Key Insights
|
||||
|
||||
### 1. Validation is Iterative
|
||||
Don't expect to get it right on the first try. The data shows 2-3 iterations is normal!
|
||||
Don't expect to get it right on the first try. Multiple validation cycles (typically 2-3) are normal and expected!
|
||||
|
||||
### 2. False Positives Exist
|
||||
~40% of warnings are accepted in production workflows. Learn to recognize them.
|
||||
Many validation warnings are acceptable in production workflows. This skill helps you recognize which ones to address vs. which to ignore.
|
||||
|
||||
### 3. Auto-Sanitization Works
|
||||
Operator structure issues (2% of errors) are auto-fixed. Don't manually fix these!
|
||||
Certain error types (like operator structure issues) are automatically fixed by n8n. Don't waste time manually fixing these!
|
||||
|
||||
### 4. Profile Matters
|
||||
- `ai-friendly` reduces false positives by 60%
|
||||
|
||||
Reference in New Issue
Block a user