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
n8n-mcp Skills - Distribution Packages
This folder contains distribution packages for different Claude platforms.
📦 Available Packages
For Claude.ai Users (Individual Skills)
Upload each skill separately via Settings → Features → Skills:
n8n-expression-syntax-v1.0.0.zip- n8n expression syntax and common patternsn8n-mcp-tools-expert-v1.0.0.zip- Expert guide for using n8n-mcp tools (recommended to install first)n8n-workflow-patterns-v1.0.0.zip- 5 proven workflow architectural patternsn8n-validation-expert-v1.0.0.zip- Validation error interpretation and fixingn8n-node-configuration-v1.0.0.zip- Operation-aware node configuration
Installation:
- Go to Settings → Features → Skills
- Click "Upload Skill"
- Select one of the skill zip files above
- Repeat for each skill you want to install
Note: Each skill can be installed independently. Install all 5 for the complete experience!
For Claude Code Users (Bundle)
n8n-mcp-skills-claude-code-v1.0.0.zip- Complete bundle with all 5 skills
Installation:
Option 1 - Manual Installation:
# 1. Download the bundle
# 2. Extract the zip file
unzip n8n-mcp-skills-claude-code-v1.0.0.zip
# 3. Copy skills to your Claude Code skills directory
cp -r skills/* ~/.claude/skills/
# 4. Reload Claude Code
Option 2 - Plugin Installation (if supported):
# Install as a Claude Code plugin
claude-code install n8n-mcp-skills-claude-code-v1.0.0.zip
🎯 Which Package Should I Use?
| Platform | Package | Skills |
|---|---|---|
| Claude.ai | Individual zips | Upload each skill separately (5 uploads) |
| Claude Code | Bundle zip | Install all 5 skills at once |
| Claude API | Bundle zip | Extract and use skills/ folder |
📋 What's Included in Each Package
Individual Skill Packages (Claude.ai)
Each zip contains:
SKILL.md # Main skill instructions with YAML frontmatter
[Reference files] # Additional documentation and guides
README.md # Skill metadata and statistics
Bundle Package (Claude Code)
plugin.json # Claude Code plugin metadata
README.md # Project overview and documentation
LICENSE # MIT License
skills/ # All 5 skills in subfolders
├── n8n-expression-syntax/
├── n8n-mcp-tools-expert/
├── n8n-workflow-patterns/
├── n8n-validation-expert/
└── n8n-node-configuration/
✅ Verification
After installation, test skills by asking:
"How do I write n8n expressions?"
→ Should activate: n8n Expression Syntax
"Find me a Slack node"
→ Should activate: n8n MCP Tools Expert
"Build a webhook workflow"
→ Should activate: n8n Workflow Patterns
🔧 Requirements
- n8n-mcp MCP server installed and configured (Installation Guide)
- Claude Pro, Max, Team, or Enterprise plan (for Claude.ai skills)
- .mcp.json configured with n8n-mcp server
📖 Documentation
For detailed installation instructions, see:
- Main README:
../README.md - Installation Guide:
../docs/INSTALLATION.md - Usage Guide:
../docs/USAGE.md
🐛 Troubleshooting
Claude.ai Error: "Zip must contain exactly one SKILL.md file"
- Use the individual skill zips, not the bundle
- Each skill must be uploaded separately
Claude Code: Skills not activating
- Verify skills are in
~/.claude/skills/directory - Check that n8n-mcp MCP server is running
- Reload Claude Code
Skills not triggering
- Skills activate based on keywords in your queries
- Try more specific questions matching skill descriptions
- Check that SKILL.md files have correct frontmatter
📝 License
MIT License - see ../LICENSE file
🙏 Credits
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
Part of the n8n-mcp project.