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
2025-10-20 13:05:41 +02:00
parent 94c7036d29
commit e19ea6ea8d
11 changed files with 50 additions and 91 deletions

View File

@@ -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%