ros/n8n-skills
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-skills.git synced 2026-03-16 23:43:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
32f249572a23aca0453f8341c7375d7ca1beca64
n8n-skills/dist/README.md
czlonkowski 32f249572a feat: Add complete bundle distribution package (v1.0.0) 
Creates complete distribution package with all 7 skills.

## Distribution Package

**n8n-mcp-skills-v1.0.0.zip** (168 KB, 50 files)
- All 7 skills in one package
- Includes .claude-plugin/ directory (plugin.json, marketplace.json)
- Ready for Claude Code plugin installation

## Package Contents

**7 Skills Included**:
1. n8n Expression Syntax
2. n8n MCP Tools Expert
3. n8n Workflow Patterns
4. n8n Validation Expert
5. n8n Node Configuration
6. n8n Code JavaScript (NEW)
7. n8n Code Python (NEW)

**Structure**:
```
.claude-plugin/
  ├── plugin.json
  └── marketplace.json
skills/
  ├── n8n-expression-syntax/
  ├── n8n-mcp-tools-expert/
  ├── n8n-workflow-patterns/
  ├── n8n-validation-expert/
  ├── n8n-node-configuration/
  ├── n8n-code-javascript/
  └── n8n-code-python/
README.md
LICENSE
```

## Updated dist/README.md

- Added complete bundle as recommended package
- Updated from 5 skills to 7 skills
- Added installation instructions for complete bundle
- Added verification examples for Code skills
- Noted that Code skills are only in complete bundle
- Marked old bundle name as legacy

## Installation Methods

**Method 1: Direct plugin installation**
```bash
/plugin install czlonkowski/n8n-skills
```

**Method 2: From marketplace**
```bash
/plugin marketplace add czlonkowski/n8n-skills
/plugin install
```

**Method 3: Local zip**
```bash
/plugin install /path/to/n8n-mcp-skills-v1.0.0.zip
```

## Package Statistics

- **Total size**: 168 KB (compressed)
- **Files**: 50 files
- **Skills**: 7 complete skills
- **Lines of code**: ~20,000+ lines across all skills
- **Evaluations**: 23 test scenarios

## Version

Version: 1.0.0
Release Date: October 20, 2025

🤖 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
2025-10-20 14:37:51 +02:00

4.7 KiB
Raw Blame History

n8n-mcp Skills - Distribution Packages

This folder contains distribution packages for different Claude platforms.

📦 Available Packages

Complete Bundle (Recommended)

  • n8n-mcp-skills-v1.0.0.zip (168 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.0.0.zip

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: JavaScript and Python Code skills are only available in the complete bundle.

Legacy Packages

  • n8n-mcp-skills-claude-code-v1.0.0.zip - Old bundle name (use n8n-mcp-skills-v1.0.0.zip instead)

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 (5) + Bundle (2) Upload separately or use bundle
Claude Code Complete bundle Install all 7 skills at once
Claude API Complete bundle 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)

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