diff --git a/dist/README.md b/dist/README.md new file mode 100644 index 0000000..241dd2d --- /dev/null +++ b/dist/README.md @@ -0,0 +1,134 @@ +# 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 patterns +- `n8n-mcp-tools-expert-v1.0.0.zip` - Expert guide for using n8n-mcp tools (HIGHEST PRIORITY) +- `n8n-workflow-patterns-v1.0.0.zip` - 5 proven workflow architectural patterns +- `n8n-validation-expert-v1.0.0.zip` - Validation error interpretation and fixing +- `n8n-node-configuration-v1.0.0.zip` - Operation-aware node configuration + +**Installation:** +1. Go to Settings β†’ Features β†’ Skills +2. Click "Upload Skill" +3. Select one of the skill zip files above +4. 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: +```bash +# 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): +```bash +# 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 +- **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. diff --git a/dist/n8n-expression-syntax-v1.0.0.zip b/dist/n8n-expression-syntax-v1.0.0.zip new file mode 100644 index 0000000..f8a9a26 Binary files /dev/null and b/dist/n8n-expression-syntax-v1.0.0.zip differ diff --git a/dist/n8n-mcp-skills-claude-code-v1.0.0.zip b/dist/n8n-mcp-skills-claude-code-v1.0.0.zip new file mode 100644 index 0000000..db2e3f7 Binary files /dev/null and b/dist/n8n-mcp-skills-claude-code-v1.0.0.zip differ diff --git a/dist/n8n-mcp-tools-expert-v1.0.0.zip b/dist/n8n-mcp-tools-expert-v1.0.0.zip new file mode 100644 index 0000000..f738db6 Binary files /dev/null and b/dist/n8n-mcp-tools-expert-v1.0.0.zip differ diff --git a/dist/n8n-node-configuration-v1.0.0.zip b/dist/n8n-node-configuration-v1.0.0.zip new file mode 100644 index 0000000..649ea04 Binary files /dev/null and b/dist/n8n-node-configuration-v1.0.0.zip differ diff --git a/dist/n8n-validation-expert-v1.0.0.zip b/dist/n8n-validation-expert-v1.0.0.zip new file mode 100644 index 0000000..2485e92 Binary files /dev/null and b/dist/n8n-validation-expert-v1.0.0.zip differ diff --git a/dist/n8n-workflow-patterns-v1.0.0.zip b/dist/n8n-workflow-patterns-v1.0.0.zip new file mode 100644 index 0000000..c00861e Binary files /dev/null and b/dist/n8n-workflow-patterns-v1.0.0.zip differ diff --git a/plugin.json b/plugin.json new file mode 100644 index 0000000..85765eb --- /dev/null +++ b/plugin.json @@ -0,0 +1,29 @@ +{ + "name": "n8n-mcp-skills", + "version": "1.0.0", + "description": "Expert skills for building n8n workflows with n8n-mcp", + "author": "Romuald CzΕ‚onkowski (https://www.aiadvisors.pl/en)", + "license": "MIT", + "skills": [ + "skills/n8n-expression-syntax", + "skills/n8n-mcp-tools-expert", + "skills/n8n-workflow-patterns", + "skills/n8n-validation-expert", + "skills/n8n-node-configuration" + ], + "requires": { + "mcp_servers": ["n8n-mcp"] + }, + "keywords": [ + "n8n", + "workflow", + "automation", + "mcp", + "validation", + "expressions" + ], + "repository": { + "type": "git", + "url": "https://github.com/czlonkowski/n8n-skills" + } +}