mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 23:43:08 +00:00
d9c2872029
BREAKING: Updated all skills to reflect n8n-mcp tool consolidation:
## Tool API Changes
- get_node_essentials → get_node({detail: "standard"})
- get_node_info → get_node({detail: "full"})
- get_node_documentation → get_node({mode: "docs"})
- search_node_properties → get_node({mode: "search_properties"})
- validate_node_minimal → validate_node({mode: "minimal"})
- validate_node_operation → validate_node({mode: "full"})
- get_property_dependencies → REMOVED (use get_node modes)
## New Features Documented
- Workflow activation via API (activateWorkflow/deactivateWorkflow operations)
- n8n_deploy_template - deploy templates directly to n8n
- n8n_workflow_versions - version history and rollback
- n8n_test_workflow - trigger execution
- n8n_executions - manage executions
- Smart parameters (branch, case) for IF/Switch connections
- Intent parameter for better AI responses
## Documentation Updates
- Added YouTube video introduction with thumbnail
- Added GitHub stars badge (1.2k milestone)
- Added build.sh script for dist packaging
- Fixed "5 skills" → "7 skills" inconsistency in README
## Files Updated
- n8n-mcp-tools-expert: Complete rewrite of SKILL.md, SEARCH_GUIDE.md,
VALIDATION_GUIDE.md, WORKFLOW_GUIDE.md
- n8n-node-configuration: Updated SKILL.md, DEPENDENCIES.md
- n8n-validation-expert: Updated SKILL.md, ERROR_CATALOG.md, FALSE_POSITIVES.md
- n8n-workflow-patterns: Updated SKILL.md, README.md
- README.md, CLAUDE.md: Modernized documentation
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
162 lines
4.8 KiB
Markdown
162 lines
4.8 KiB
Markdown
# n8n-mcp Skills - Distribution Packages
|
|
|
|
This folder contains distribution packages for different Claude platforms.
|
|
|
|
## 📦 Available Packages
|
|
|
|
### Complete Bundle (Recommended)
|
|
|
|
- **`n8n-mcp-skills-v1.1.0.zip`** (172 KB) - All 7 skills in one package
|
|
|
|
**Includes:**
|
|
- Skill #1: n8n Expression Syntax
|
|
- Skill #2: n8n MCP Tools Expert
|
|
- Skill #3: n8n Workflow Patterns
|
|
- Skill #4: n8n Validation Expert
|
|
- Skill #5: n8n Node Configuration
|
|
- Skill #6: n8n Code JavaScript
|
|
- Skill #7: n8n Code Python
|
|
|
|
**Installation:**
|
|
```bash
|
|
# Claude Code plugin installation
|
|
/plugin install czlonkowski/n8n-skills
|
|
|
|
# Or install from local file
|
|
/plugin install /path/to/n8n-mcp-skills-v1.1.0.zip
|
|
```
|
|
|
|
### For Claude.ai Users (Individual Skills)
|
|
|
|
Upload each skill separately via Settings → Capabilities → Skills (bottom of page):
|
|
|
|
- `n8n-expression-syntax-v1.1.0.zip` - n8n expression syntax and common patterns
|
|
- `n8n-mcp-tools-expert-v1.1.0.zip` - Expert guide for using n8n-mcp tools (recommended to install first)
|
|
- `n8n-workflow-patterns-v1.1.0.zip` - 5 proven workflow architectural patterns
|
|
- `n8n-validation-expert-v1.1.0.zip` - Validation error interpretation and fixing
|
|
- `n8n-node-configuration-v1.1.0.zip` - Operation-aware node configuration
|
|
|
|
**Installation:**
|
|
1. Go to Settings → Capabilities → Skills (bottom of page)
|
|
2. Click "Upload Skill"
|
|
3. Select one of the skill zip files above
|
|
4. Repeat for each skill you want to install
|
|
|
|
**Note:** JavaScript and Python Code skills are only available in the complete bundle (not as individual skills).
|
|
|
|
## 🎯 Which Package Should I Use?
|
|
|
|
| Platform | Package | What You Get |
|
|
|----------|---------|--------------|
|
|
| **Claude.ai** | Individual zips | 5 core skills (upload separately) |
|
|
| **Claude Code** | Complete bundle (n8n-mcp-skills-v1.1.0.zip) | All 7 skills at once |
|
|
| **Claude API** | Complete bundle | All 7 skills (extract skills/ folder) |
|
|
|
|
**Note:** Code skills (#6 JavaScript, #7 Python) are only in the complete bundle.
|
|
|
|
---
|
|
|
|
## 📁 Files in This Directory
|
|
|
|
```
|
|
dist/
|
|
├── n8n-mcp-skills-v1.1.0.zip (168 KB) ★ RECOMMENDED
|
|
├── n8n-expression-syntax-v1.1.0.zip (11 KB)
|
|
├── n8n-mcp-tools-expert-v1.1.0.zip (15 KB)
|
|
├── n8n-workflow-patterns-v1.1.0.zip (35 KB)
|
|
├── n8n-validation-expert-v1.1.0.zip (18 KB)
|
|
├── n8n-node-configuration-v1.1.0.zip (17 KB)
|
|
└── README.md (this file)
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 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)
|
|
|
|
```
|
|
.claude-plugin/
|
|
├── plugin.json # Claude Code plugin metadata
|
|
└── marketplace.json # Marketplace listing metadata
|
|
README.md # Project overview and documentation
|
|
LICENSE # MIT License
|
|
skills/ # All 7 skills in subfolders
|
|
├── n8n-expression-syntax/
|
|
├── n8n-mcp-tools-expert/
|
|
├── n8n-workflow-patterns/
|
|
├── n8n-validation-expert/
|
|
├── n8n-node-configuration/
|
|
├── n8n-code-javascript/
|
|
└── n8n-code-python/
|
|
```
|
|
|
|
## ✅ 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
|
|
|
|
"How do I access webhook data in a Code node?"
|
|
→ Should activate: n8n Code JavaScript
|
|
|
|
"Can I use pandas in Python Code node?"
|
|
→ Should activate: n8n Code Python
|
|
```
|
|
|
|
## 🔧 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).
|