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
ec350daa6e148733ddb7d0c74b25c8dc69879b12
n8n-skills/dist/README.md
czlonkowski a82cd0cd5b docs: Update dist/README.md - clarify packages and fix Claude.ai path 
Updates distribution documentation for clarity.

## Changes

**Fixed Claude.ai path**:
- Changed: Settings → Features → Skills
- To: Settings → Capabilities → Skills (bottom of page)

**Removed legacy package**:
- Deleted n8n-mcp-skills-claude-code-v1.0.0.zip (103 KB, 5 skills only)
- Removed from documentation
- Only keeping n8n-mcp-skills-v1.0.0.zip (168 KB, 7 skills) going forward

**Clarified package usage**:
- Added "Files in This Directory" section showing actual files
- Improved "Which Package Should I Use?" table
- Clear note: Code skills (#6, #7) only in complete bundle
- Removed confusing legacy installation instructions

**Simplified structure**:
```
dist/
├── n8n-mcp-skills-v1.0.0.zip       (168 KB) ★ Complete bundle (7 skills)
├── [5 individual skill zips]        (11-35 KB each)
└── README.md
```

Co-Authored-By: Claude <noreply@anthropic.com>
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 14:41:30 +02:00

4.8 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 → Capabilities → Skills (bottom of page):

  • 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 → 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.0.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.0.0.zip              (168 KB) ★ RECOMMENDED
├── n8n-expression-syntax-v1.0.0.zip       (11 KB)
├── n8n-mcp-tools-expert-v1.0.0.zip        (15 KB)
├── n8n-workflow-patterns-v1.0.0.zip       (35 KB)
├── n8n-validation-expert-v1.0.0.zip       (18 KB)
├── n8n-node-configuration-v1.0.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.