From c84d605f302db5f405234f57c69962b222b20eb1 Mon Sep 17 00:00:00 2001 From: czlonkowski <56956555+czlonkowski@users.noreply.github.com> Date: Mon, 20 Oct 2025 13:15:33 +0200 Subject: [PATCH] feat: Add Claude Code plugin and marketplace support MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Implement full Claude Code plugin structure with marketplace support, enabling easy installation via /plugin commands. ## Changes ### Plugin Structure (Standard Compliant) **Created `.claude-plugin/` directory with:** - `plugin.json` - Moved from root, updated to standard schema - `marketplace.json` - NEW: Enables marketplace discovery **plugin.json changes:** - ❌ Removed non-standard `skills` array (auto-discovered from skills/ directory) - ❌ Removed non-standard `requires` field - ✅ Updated `author` from string to object with name and url - ✅ Added `homepage` field - ✅ Follows official Claude Code plugin schema ### Installation Methods **Method 1 - Direct Plugin Install** (Recommended): ```bash /plugin install czlonkowski/n8n-skills ``` **Method 2 - Marketplace**: ```bash /plugin marketplace add czlonkowski/n8n-skills /plugin install # Then select from list ``` **Method 3 - Manual**: Clone and copy (unchanged) ### Repository Structure ``` n8n-skills/ ├── .claude-plugin/ # NEW - Plugin metadata │ ├── plugin.json # Standard schema │ └── marketplace.json # Marketplace listing ├── skills/ # Auto-discovered by Claude Code │ ├── n8n-expression-syntax/ │ ├── n8n-mcp-tools-expert/ │ ├── n8n-workflow-patterns/ │ ├── n8n-validation-expert/ │ └── n8n-node-configuration/ └── dist/ └── n8n-mcp-skills-claude-code-v1.0.0.zip # Updated with .claude-plugin/ ``` ### Benefits ✅ **One-command installation**: `/plugin install czlonkowski/n8n-skills` ✅ **Marketplace ready**: Can be browsed via marketplace UI ✅ **Auto-discovery**: Skills automatically detected from skills/ directory ✅ **Standard compliant**: Follows official Claude Code plugin specification ✅ **Dual distribution**: Works as both plugin and marketplace ### Documentation Updated README.md with three installation methods: 1. Plugin install (recommended) 2. Marketplace browse and install 3. Manual installation (backward compatible) Distribution package regenerated with .claude-plugin/ directory. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en --- .claude-plugin/marketplace.json | 33 +++++++++++++++++++++ plugin.json => .claude-plugin/plugin.json | 18 ++++------- README.md | 17 +++++++++++ dist/n8n-mcp-skills-claude-code-v1.0.0.zip | Bin 103911 -> 105266 bytes 4 files changed, 56 insertions(+), 12 deletions(-) create mode 100644 .claude-plugin/marketplace.json rename plugin.json => .claude-plugin/plugin.json (53%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..04a8949 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,33 @@ +{ + "name": "n8n-mcp-skills", + "description": "Expert skills for building n8n workflows", + "owner": { + "name": "Romuald Członkowski", + "url": "https://www.aiadvisors.pl/en" + }, + "plugins": [ + { + "name": "n8n-mcp-skills", + "source": ".", + "description": "Complete bundle: 5 expert skills for building flawless n8n workflows using n8n-mcp MCP server. Includes skills for expression syntax, MCP tools usage, workflow patterns, validation, and node configuration.", + "version": "1.0.0", + "author": { + "name": "Romuald Członkowski", + "url": "https://www.aiadvisors.pl/en" + }, + "category": "automation", + "keywords": [ + "n8n", + "workflow", + "mcp", + "automation", + "validation", + "expressions", + "skills" + ], + "homepage": "https://github.com/czlonkowski/n8n-skills", + "repository": "https://github.com/czlonkowski/n8n-skills", + "license": "MIT" + } + ] +} diff --git a/plugin.json b/.claude-plugin/plugin.json similarity index 53% rename from plugin.json rename to .claude-plugin/plugin.json index 85765eb..154d574 100644 --- a/plugin.json +++ b/.claude-plugin/plugin.json @@ -2,18 +2,11 @@ "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"] + "author": { + "name": "Romuald Członkowski", + "url": "https://www.aiadvisors.pl/en" }, + "license": "MIT", "keywords": [ "n8n", "workflow", @@ -25,5 +18,6 @@ "repository": { "type": "git", "url": "https://github.com/czlonkowski/n8n-skills" - } + }, + "homepage": "https://github.com/czlonkowski/n8n-skills" } diff --git a/README.md b/README.md index b8ae256..69f35a4 100644 --- a/README.md +++ b/README.md @@ -102,6 +102,23 @@ Operation-aware node configuration guidance. ### Claude Code +**Method 1: Plugin Installation** (Recommended) +```bash +# Install directly as a Claude Code plugin +/plugin install czlonkowski/n8n-skills +``` + +**Method 2: Via Marketplace** +```bash +# Add as marketplace, then browse and install +/plugin marketplace add czlonkowski/n8n-skills + +# Then browse available plugins +/plugin install +# Select "n8n-mcp-skills" from the list +``` + +**Method 3: Manual Installation** ```bash # 1. Clone this repository git clone https://github.com/czlonkowski/n8n-skills.git diff --git a/dist/n8n-mcp-skills-claude-code-v1.0.0.zip b/dist/n8n-mcp-skills-claude-code-v1.0.0.zip index 5d19eaf2112631b4d3a10f3381e770bdc0562384..218d2eaccb429ba9f25542c3b74b72020d58ec37 100644 GIT binary patch delta 4643 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 HXE^@>IMYNY delta 3359 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