mirror of
https://github.com/czlonkowski/n8n-skills.git
synced 2026-03-16 23:43:08 +00:00
c84d605f30
Implement full Claude Code plugin structure with marketplace support, enabling easy installation via /plugin commands. ## Changes ### Plugin Structure (Standard Compliant) **Created `.claude-plugin/` directory with:** - `plugin.json` - Moved from root, updated to standard schema - `marketplace.json` - NEW: Enables marketplace discovery **plugin.json changes:** - ❌ Removed non-standard `skills` array (auto-discovered from skills/ directory) - ❌ Removed non-standard `requires` field - ✅ Updated `author` from string to object with name and url - ✅ Added `homepage` field - ✅ Follows official Claude Code plugin schema ### Installation Methods **Method 1 - Direct Plugin Install** (Recommended): ```bash /plugin install czlonkowski/n8n-skills ``` **Method 2 - Marketplace**: ```bash /plugin marketplace add czlonkowski/n8n-skills /plugin install # Then select from list ``` **Method 3 - Manual**: Clone and copy (unchanged) ### Repository Structure ``` n8n-skills/ ├── .claude-plugin/ # NEW - Plugin metadata │ ├── plugin.json # Standard schema │ └── marketplace.json # Marketplace listing ├── skills/ # Auto-discovered by Claude Code │ ├── n8n-expression-syntax/ │ ├── n8n-mcp-tools-expert/ │ ├── n8n-workflow-patterns/ │ ├── n8n-validation-expert/ │ └── n8n-node-configuration/ └── dist/ └── n8n-mcp-skills-claude-code-v1.0.0.zip # Updated with .claude-plugin/ ``` ### Benefits ✅ **One-command installation**: `/plugin install czlonkowski/n8n-skills` ✅ **Marketplace ready**: Can be browsed via marketplace UI ✅ **Auto-discovery**: Skills automatically detected from skills/ directory ✅ **Standard compliant**: Follows official Claude Code plugin specification ✅ **Dual distribution**: Works as both plugin and marketplace ### Documentation Updated README.md with three installation methods: 1. Plugin install (recommended) 2. Marketplace browse and install 3. Manual installation (backward compatible) Distribution package regenerated with .claude-plugin/ directory. 🤖 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
n8n-mcp Skills - Distribution Packages
This folder contains distribution packages for different Claude platforms.
📦 Available Packages
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 patternsn8n-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 patternsn8n-validation-expert-v1.0.0.zip- Validation error interpretation and fixingn8n-node-configuration-v1.0.0.zip- Operation-aware node configuration
Installation:
- Go to Settings → Features → Skills
- Click "Upload Skill"
- Select one of the skill zip files above
- Repeat for each skill you want to install
Note: Each skill can be installed independently. Install all 5 for the complete experience!
For Claude Code Users (Bundle)
n8n-mcp-skills-claude-code-v1.0.0.zip- Complete bundle with all 5 skills
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 | Upload each skill separately (5 uploads) |
| Claude Code | Bundle zip | Install all 5 skills at once |
| Claude API | Bundle zip | 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)
plugin.json # Claude Code plugin metadata
README.md # Project overview and documentation
LICENSE # MIT License
skills/ # All 5 skills in subfolders
├── n8n-expression-syntax/
├── n8n-mcp-tools-expert/
├── n8n-workflow-patterns/
├── n8n-validation-expert/
└── n8n-node-configuration/
✅ 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
🔧 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.