mirror of
https://mirror.skon.top/github.com/czlonkowski/n8n-skills
synced 2026-04-20 12:52:35 +08:00
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:
7
build.sh
7
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)
|
||||
|
||||
118
dist/README.md
vendored
118
dist/README.md
vendored
@@ -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
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
BIN
dist/n8n-code-python-v1.3.0.zip
vendored
Normal file
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Reference in New Issue
Block a user