diff --git a/build.sh b/build.sh index 34678a2..5066974 100755 --- a/build.sh +++ b/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) diff --git a/dist/README.md b/dist/README.md index 1847361..49bbd52 100644 --- a/dist/README.md +++ b/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:** -- 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.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). diff --git a/dist/n8n-code-javascript-v1.3.0.zip b/dist/n8n-code-javascript-v1.3.0.zip new file mode 100644 index 0000000..66a2ecb Binary files /dev/null and b/dist/n8n-code-javascript-v1.3.0.zip differ diff --git a/dist/n8n-code-python-v1.3.0.zip b/dist/n8n-code-python-v1.3.0.zip new file mode 100644 index 0000000..fd85c8a Binary files /dev/null and b/dist/n8n-code-python-v1.3.0.zip differ diff --git a/dist/n8n-expression-syntax-v1.2.0.zip b/dist/n8n-expression-syntax-v1.3.0.zip similarity index 82% rename from dist/n8n-expression-syntax-v1.2.0.zip rename to dist/n8n-expression-syntax-v1.3.0.zip index 55e450a..f8137f4 100644 Binary files a/dist/n8n-expression-syntax-v1.2.0.zip and b/dist/n8n-expression-syntax-v1.3.0.zip differ diff --git a/dist/n8n-mcp-skills-v1.2.0.zip b/dist/n8n-mcp-skills-v1.3.0.zip similarity index 100% rename from dist/n8n-mcp-skills-v1.2.0.zip rename to dist/n8n-mcp-skills-v1.3.0.zip diff --git a/dist/n8n-mcp-tools-expert-v1.2.0.zip b/dist/n8n-mcp-tools-expert-v1.3.0.zip similarity index 89% rename from dist/n8n-mcp-tools-expert-v1.2.0.zip rename to dist/n8n-mcp-tools-expert-v1.3.0.zip index c6d90ae..23c28f6 100644 Binary files a/dist/n8n-mcp-tools-expert-v1.2.0.zip and b/dist/n8n-mcp-tools-expert-v1.3.0.zip differ diff --git a/dist/n8n-node-configuration-v1.2.0.zip b/dist/n8n-node-configuration-v1.3.0.zip similarity index 78% rename from dist/n8n-node-configuration-v1.2.0.zip rename to dist/n8n-node-configuration-v1.3.0.zip index 1b105b6..6b6984d 100644 Binary files a/dist/n8n-node-configuration-v1.2.0.zip and b/dist/n8n-node-configuration-v1.3.0.zip differ diff --git a/dist/n8n-validation-expert-v1.2.0.zip b/dist/n8n-validation-expert-v1.3.0.zip similarity index 91% rename from dist/n8n-validation-expert-v1.2.0.zip rename to dist/n8n-validation-expert-v1.3.0.zip index 989b07c..329234e 100644 Binary files a/dist/n8n-validation-expert-v1.2.0.zip and b/dist/n8n-validation-expert-v1.3.0.zip differ diff --git a/dist/n8n-workflow-patterns-v1.2.0.zip b/dist/n8n-workflow-patterns-v1.3.0.zip similarity index 92% rename from dist/n8n-workflow-patterns-v1.2.0.zip rename to dist/n8n-workflow-patterns-v1.3.0.zip index 29d7b38..28f4755 100644 Binary files a/dist/n8n-workflow-patterns-v1.2.0.zip and b/dist/n8n-workflow-patterns-v1.3.0.zip differ