Files
Romuald Członkowski d9c2872029 feat: Update skills for n8n-mcp unified tool API (v1.1.0)
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>
2026-01-08 15:37:57 +01:00
..

n8n-mcp Skills - Distribution Packages

This folder contains distribution packages for different Claude platforms.

📦 Available Packages

  • 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 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)
  • 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.