czlonkowski
c84d605f30
feat: Add Claude Code plugin and marketplace support
...
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 <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 13:15:33 +02:00
czlonkowski
e19ea6ea8d
docs: Remove telemetry and research context from user-facing documentation
...
Clean up all README files to focus on user value rather than research metrics.
Remove telemetry numbers and research context that isn't useful for end users.
## Changes
**Main README.md**:
- Removed "Based on 447,557 real MCP tool usage events" section
- Replaced failure rate metrics with user benefits
- Removed entire "Data-Driven Design" section with telemetry statistics
- Fixed all GitHub links to use czlonkowski/n8n-mcp
- Updated "Repository Stats" to "What's Included" with user-focused content
**dist/README.md**:
- Changed "HIGHEST PRIORITY" to "recommended to install first"
- Added link to n8n-mcp repository
- More user-friendly language throughout
**Skill README.md files**:
- n8n-mcp-tools-expert: Removed "447,557 events", "20% failure rate" metrics
- n8n-workflow-patterns: Removed "Based on 31,917 real workflows"
- n8n-validation-expert: Removed "From 7,841 validate → fix cycles"
- Replaced frequency percentages with priority levels (Highest/High/Medium/Low)
- Reframed "Success Metrics" as "What You'll Learn"
- Changed "Critical Insights from telemetry" to "Key Insights" for users
## Kept What Matters
- Template counts (2,653+) - this is a feature, not research
- Node counts (525+) - this is a feature
- Practical insights (validation takes 2-3 iterations, false positives exist)
- Best practices and common patterns
## Result
Documentation now focuses on what users need to know to use the skills
effectively, rather than the research that informed their creation.
All distribution packages regenerated with cleaned documentation.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 13:05:41 +02:00
czlonkowski
94c7036d29
fix: Use lowercase-with-hyphens skill names for Claude.ai compatibility
...
Fix skill names in SKILL.md frontmatter to comply with Claude.ai requirements:
"Skill name in SKILL.md can only contain lowercase letters, numbers, and hyphens."
## Changes
Updated skill names from "Title Case With Spaces" to "lowercase-with-hyphens":
1. "n8n Expression Syntax" → "n8n-expression-syntax"
2. "n8n MCP Tools Expert" → "n8n-mcp-tools-expert"
3. "n8n Workflow Patterns" → "n8n-workflow-patterns"
4. "n8n Validation Expert" → "n8n-validation-expert"
5. "n8n Node Configuration" → "n8n-node-configuration"
## Files Modified
- skills/n8n-expression-syntax/SKILL.md
- skills/n8n-mcp-tools-expert/SKILL.md
- skills/n8n-workflow-patterns/SKILL.md
- skills/n8n-validation-expert/SKILL.md
- skills/n8n-node-configuration/SKILL.md
## Distribution Packages
Regenerated all distribution zip files with corrected SKILL.md:
- dist/n8n-expression-syntax-v1.0.0.zip
- dist/n8n-mcp-tools-expert-v1.0.0.zip
- dist/n8n-workflow-patterns-v1.0.0.zip
- dist/n8n-validation-expert-v1.0.0.zip
- dist/n8n-node-configuration-v1.0.0.zip
- dist/n8n-mcp-skills-claude-code-v1.0.0.zip
Skills can now be uploaded to Claude.ai without naming errors.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 12:51:33 +02:00
czlonkowski
3866d1bc2a
feat: Add distribution packages for Claude.ai and Claude Code
...
Create production-ready distribution packages for different Claude platforms.
## Distribution Packages
**For Claude.ai (Individual Skills)**:
- n8n-expression-syntax-v1.0.0.zip
- n8n-mcp-tools-expert-v1.0.0.zip
- n8n-workflow-patterns-v1.0.0.zip
- n8n-validation-expert-v1.0.0.zip
- n8n-node-configuration-v1.0.0.zip
Each skill packaged individually with files at root level (SKILL.md, reference
files, README.md). Complies with Claude.ai skill upload requirements: exactly
one SKILL.md per zip, files at root, YAML frontmatter included.
**For Claude Code (Bundle)**:
- n8n-mcp-skills-claude-code-v1.0.0.zip
Complete bundle with plugin.json, all 5 skills in skills/ folder, README, and
LICENSE. Ready for Claude Code plugin installation.
## Files Added
1. plugin.json - Claude Code plugin metadata (name, version, skills array)
2. dist/ folder with:
- 5 individual skill zips (Claude.ai format)
- 1 bundle zip (Claude Code format)
- README.md (distribution guide)
## Zip Structure
**Individual Skills** (Claude.ai):
```
skill-name.zip
├── SKILL.md (with frontmatter)
├── [reference-files].md
└── README.md
```
**Bundle** (Claude Code):
```
bundle.zip
├── plugin.json
├── README.md
├── LICENSE
└── skills/
├── n8n-expression-syntax/
├── n8n-mcp-tools-expert/
├── n8n-workflow-patterns/
├── n8n-validation-expert/
└── n8n-node-configuration/
```
## Usage
**Claude.ai**: Upload each skill zip separately via Settings → Features → Skills
**Claude Code**: Extract bundle and copy skills/ to ~/.claude/skills/
Total package sizes:
- Individual skills: 11KB - 36KB each
- Bundle: 102KB (all 5 skills + metadata)
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 12:46:14 +02:00
