mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 15:33:09 +00:00
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>
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:
# 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 patternsn8n-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 patternsn8n-validation-expert-v1.1.0.zip- Validation error interpretation and fixingn8n-node-configuration-v1.1.0.zip- Operation-aware node configuration
Installation:
- Go to Settings → Capabilities → Skills (bottom of page)
- Click "Upload Skill"
- Select one of the skill zip files above
- 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)
- 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.