mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-19 08:53:10 +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
135 lines
3.9 KiB
Markdown
135 lines
3.9 KiB
Markdown
# 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 patterns
|
|
- `n8n-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 patterns
|
|
- `n8n-validation-expert-v1.0.0.zip` - Validation error interpretation and fixing
|
|
- `n8n-node-configuration-v1.0.0.zip` - Operation-aware node configuration
|
|
|
|
**Installation:**
|
|
1. Go to Settings → Features → Skills
|
|
2. Click "Upload Skill"
|
|
3. Select one of the skill zip files above
|
|
4. 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:
|
|
```bash
|
|
# 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):
|
|
```bash
|
|
# 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](https://github.com/czlonkowski/n8n-mcp))
|
|
- **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](https://github.com/czlonkowski/n8n-mcp).
|