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>

build.sh

@@ -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)

dist/README.md

@@ -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:**
+- `n8n-expression-syntax-v1.3.0.zip` - n8n expression syntax and common patterns
-- Skill #1: n8n Expression Syntax
+- `n8n-mcp-tools-expert-v1.3.0.zip` - Expert guide for using n8n-mcp tools (recommended to install first)
-- Skill #2: n8n MCP Tools Expert
+- `n8n-workflow-patterns-v1.3.0.zip` - 5 proven workflow architectural patterns
-- Skill #3: n8n Workflow Patterns
+- `n8n-validation-expert-v1.3.0.zip` - Validation error interpretation and fixing
-- Skill #4: n8n Validation Expert
+- `n8n-node-configuration-v1.3.0.zip` - Operation-aware node configuration
-- Skill #5: n8n Node Configuration
+- `n8n-code-javascript-v1.3.0.zip` - JavaScript in n8n Code nodes
-- Skill #6: n8n Code JavaScript
+- `n8n-code-python-v1.3.0.zip` - Python in n8n Code nodes
-- Skill #7: n8n Code Python
+
+**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)
+## Which Package Should I Use?
-
-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?
 
 | Platform | Package | What You Get |
 |----------|---------|--------------|
-| **Claude.ai** | Individual zips | 5 core skills (upload separately) |
+| **Claude.ai / Desktop** | Individual zips | 7 skills (upload separately) |
-| **Claude Code** | Complete bundle (n8n-mcp-skills-v1.2.0.zip) | All 7 skills at once |
+| **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-code-javascript-v1.3.0.zip        (34 KB)
-├── n8n-expression-syntax-v1.2.0.zip       (11 KB)
+├── n8n-code-python-v1.3.0.zip            (31 KB)
-├── n8n-mcp-tools-expert-v1.2.0.zip        (19 KB)
+├── n8n-expression-syntax-v1.3.0.zip      (11 KB)
-├── n8n-workflow-patterns-v1.2.0.zip       (37 KB)
+├── n8n-mcp-skills-v1.3.0.zip             (174 KB)  Claude Code only
-├── n8n-validation-expert-v1.2.0.zip       (19 KB)
+├── n8n-mcp-tools-expert-v1.3.0.zip       (19 KB)
-├── n8n-node-configuration-v1.2.0.zip      (18 KB)
+├── n8n-node-configuration-v1.3.0.zip     (18 KB)
-└── README.md                               (this file)
+├── 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
+<skill-name>/
-[Reference files]     # Additional documentation and guides
+├── SKILL.md              # Main skill instructions with YAML frontmatter
-README.md             # Skill metadata and statistics
+├── [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).