fix: Correct zip structure for Claude.ai/Desktop skill uploads (v1.3.0)

Individual skill zips now have SKILL.md at the top level (<skill-name>/SKILL.md)
instead of nested under skills/ directory, fixing uploads to Claude.ai and
Claude Desktop. Also adds missing n8n-code-javascript and n8n-code-python
individual zips. Closes #19

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
czlonkowski
2026-04-03 08:50:25 +02:00
parent 6689ebc0af
commit 3db664c1bc
10 changed files with 61 additions and 64 deletions

View File

@@ -5,7 +5,7 @@
set -e
DIST_DIR="dist"
VERSION="1.1.0"
VERSION="1.3.0"
echo "🔨 Building n8n-skills distribution packages..."
@@ -17,6 +17,7 @@ echo "🗑️ Removing old zip files..."
rm -f "$DIST_DIR"/*.zip
# Build individual skill zips (for Claude.ai)
# Structure: skill-name/SKILL.md at zip root (not nested under skills/)
echo "📦 Building individual skill zips for Claude.ai..."
SKILLS=(
@@ -25,11 +26,13 @@ SKILLS=(
"n8n-workflow-patterns"
"n8n-validation-expert"
"n8n-node-configuration"
"n8n-code-javascript"
"n8n-code-python"
)
for skill in "${SKILLS[@]}"; do
echo " - $skill"
zip -rq "$DIST_DIR/${skill}-v${VERSION}.zip" "skills/${skill}/" -x "*.DS_Store"
(cd skills && zip -rq "../$DIST_DIR/${skill}-v${VERSION}.zip" "${skill}/" -x "*.DS_Store")
done
# Build complete bundle (for Claude Code)

118
dist/README.md vendored
View File

@@ -2,20 +2,31 @@
This folder contains distribution packages for different Claude platforms.
## 📦 Available Packages
## Available Packages
### Complete Bundle (Recommended)
### For Claude.ai / Claude Desktop (Individual Skills)
- **`n8n-mcp-skills-v1.2.0.zip`** (174 KB) - All 7 skills in one package
Upload each skill separately via Settings > Capabilities > Skills (bottom of page):
**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
- `n8n-expression-syntax-v1.3.0.zip` - n8n expression syntax and common patterns
- `n8n-mcp-tools-expert-v1.3.0.zip` - Expert guide for using n8n-mcp tools (recommended to install first)
- `n8n-workflow-patterns-v1.3.0.zip` - 5 proven workflow architectural patterns
- `n8n-validation-expert-v1.3.0.zip` - Validation error interpretation and fixing
- `n8n-node-configuration-v1.3.0.zip` - Operation-aware node configuration
- `n8n-code-javascript-v1.3.0.zip` - JavaScript in n8n Code nodes
- `n8n-code-python-v1.3.0.zip` - Python in n8n Code nodes
**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
### Complete Bundle (Claude Code only)
- **`n8n-mcp-skills-v1.3.0.zip`** (174 KB) - All 7 skills in one package
> **This bundle is NOT compatible with Claude.ai or Claude Desktop.** It uses a nested `skills/` directory structure required by Claude Code plugins. For Claude.ai/Desktop, use the individual skill zips above.
**Installation:**
```bash
@@ -23,66 +34,49 @@ This folder contains distribution packages for different Claude platforms.
/plugin install czlonkowski/n8n-skills
# Or install from local file
/plugin install /path/to/n8n-mcp-skills-v1.2.0.zip
/plugin install /path/to/n8n-mcp-skills-v1.3.0.zip
```
### For Claude.ai Users (Individual Skills)
Upload each skill separately via Settings → Capabilities → Skills (bottom of page):
- `n8n-expression-syntax-v1.2.0.zip` - n8n expression syntax and common patterns
- `n8n-mcp-tools-expert-v1.2.0.zip` - Expert guide for using n8n-mcp tools (recommended to install first)
- `n8n-workflow-patterns-v1.2.0.zip` - 5 proven workflow architectural patterns
- `n8n-validation-expert-v1.2.0.zip` - Validation error interpretation and fixing
- `n8n-node-configuration-v1.2.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?
## 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.2.0.zip) | All 7 skills at once |
| **Claude.ai / Desktop** | Individual zips | 7 skills (upload separately) |
| **Claude Code** | Complete bundle OR individual zips | All 7 skills |
| **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
## Files in This Directory
```
dist/
├── n8n-mcp-skills-v1.2.0.zip (174 KB) ★ RECOMMENDED
├── n8n-expression-syntax-v1.2.0.zip (11 KB)
├── n8n-mcp-tools-expert-v1.2.0.zip (19 KB)
├── n8n-workflow-patterns-v1.2.0.zip (37 KB)
├── n8n-validation-expert-v1.2.0.zip (19 KB)
├── n8n-node-configuration-v1.2.0.zip (18 KB)
── README.md (this file)
├── n8n-code-javascript-v1.3.0.zip (34 KB)
├── n8n-code-python-v1.3.0.zip (31 KB)
├── n8n-expression-syntax-v1.3.0.zip (11 KB)
├── n8n-mcp-skills-v1.3.0.zip (174 KB) Claude Code only
├── n8n-mcp-tools-expert-v1.3.0.zip (19 KB)
├── n8n-node-configuration-v1.3.0.zip (18 KB)
── n8n-validation-expert-v1.3.0.zip (19 KB)
├── n8n-workflow-patterns-v1.3.0.zip (37 KB)
└── README.md (this file)
```
---
## 📋 What's Included in Each Package
## What's Included in Each Package
### Individual Skill Packages (Claude.ai)
### Individual Skill Packages (Claude.ai / Desktop / Code)
Each zip contains:
Each zip contains a skill folder at the root with:
```
SKILL.md # Main skill instructions with YAML frontmatter
[Reference files] # Additional documentation and guides
README.md # Skill metadata and statistics
<skill-name>/
├── SKILL.md # Main skill instructions with YAML frontmatter
├── [Reference files] # Additional documentation and guides
└── README.md # Skill metadata and statistics
```
### Bundle Package (Claude Code)
### Bundle Package (Claude Code only)
```
.claude-plugin/
@@ -100,41 +94,41 @@ skills/ # All 7 skills in subfolders
└── n8n-code-python/
```
## Verification
## Verification
After installation, test skills by asking:
```
"How do I write n8n expressions?"
Should activate: n8n Expression Syntax
-> Should activate: n8n Expression Syntax
"Find me a Slack node"
Should activate: n8n MCP Tools Expert
-> Should activate: n8n MCP Tools Expert
"Build a webhook workflow"
Should activate: n8n Workflow Patterns
-> Should activate: n8n Workflow Patterns
"How do I access webhook data in a Code node?"
Should activate: n8n Code JavaScript
-> Should activate: n8n Code JavaScript
"Can I use pandas in Python Code node?"
Should activate: n8n Code Python
-> Should activate: n8n Code Python
```
## 🔧 Requirements
## Requirements
- **n8n-mcp MCP server** installed and configured ([Installation Guide](https://github.com/czlonkowski/n8n-mcp))
- **Claude Pro, Max, Team, or Enterprise** plan (for Claude.ai skills)
- **.mcp.json** configured with n8n-mcp server
## 📖 Documentation
## Documentation
For detailed installation instructions, see:
- Main README: `../README.md`
- Installation Guide: `../docs/INSTALLATION.md`
- Usage Guide: `../docs/USAGE.md`
## 🐛 Troubleshooting
## Troubleshooting
**Claude.ai Error: "Zip must contain exactly one SKILL.md file"**
- Use the individual skill zips, not the bundle
@@ -150,12 +144,12 @@ For detailed installation instructions, see:
- Try more specific questions matching skill descriptions
- Check that SKILL.md files have correct frontmatter
## 📝 License
## License
MIT License - see `../LICENSE` file
## 🙏 Credits
## Credits
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
Conceived by Romuald Czlonkowski - https://www.aiadvisors.pl/en
Part of the [n8n-mcp project](https://github.com/czlonkowski/n8n-mcp).

BIN
dist/n8n-code-javascript-v1.3.0.zip vendored Normal file

Binary file not shown.

BIN
dist/n8n-code-python-v1.3.0.zip vendored Normal file

Binary file not shown.