ros/n8n-skills
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-skills.git synced 2026-03-16 23:43:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
20 Commits 1 Branch 0 Tags
a82cd0cd5b87148accb0f7f960834c1818fda83a
Commit Graph

8 Commits

Author SHA1 Message Date
czlonkowski
a82cd0cd5b docs: Update dist/README.md - clarify packages and fix Claude.ai path 
Updates distribution documentation for clarity.

## Changes

**Fixed Claude.ai path**:
- Changed: Settings → Features → Skills
- To: Settings → Capabilities → Skills (bottom of page)

**Removed legacy package**:
- Deleted n8n-mcp-skills-claude-code-v1.0.0.zip (103 KB, 5 skills only)
- Removed from documentation
- Only keeping n8n-mcp-skills-v1.0.0.zip (168 KB, 7 skills) going forward

**Clarified package usage**:
- Added "Files in This Directory" section showing actual files
- Improved "Which Package Should I Use?" table
- Clear note: Code skills (#6, #7) only in complete bundle
- Removed confusing legacy installation instructions

**Simplified structure**:
```
dist/
├── n8n-mcp-skills-v1.0.0.zip       (168 KB) ★ Complete bundle (7 skills)
├── [5 individual skill zips]        (11-35 KB each)
└── README.md
```

Co-Authored-By: Claude <noreply@anthropic.com>
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
 2025-10-20 14:41:30 +02:00
czlonkowski
32f249572a feat: Add complete bundle distribution package (v1.0.0) 
Creates complete distribution package with all 7 skills.

## Distribution Package

**n8n-mcp-skills-v1.0.0.zip** (168 KB, 50 files)
- All 7 skills in one package
- Includes .claude-plugin/ directory (plugin.json, marketplace.json)
- Ready for Claude Code plugin installation

## Package Contents

**7 Skills Included**:
1. n8n Expression Syntax
2. n8n MCP Tools Expert
3. n8n Workflow Patterns
4. n8n Validation Expert
5. n8n Node Configuration
6. n8n Code JavaScript (NEW)
7. n8n Code Python (NEW)

**Structure**:
```
.claude-plugin/
  ├── plugin.json
  └── marketplace.json
skills/
  ├── n8n-expression-syntax/
  ├── n8n-mcp-tools-expert/
  ├── n8n-workflow-patterns/
  ├── n8n-validation-expert/
  ├── n8n-node-configuration/
  ├── n8n-code-javascript/
  └── n8n-code-python/
README.md
LICENSE
```

## Updated dist/README.md

- Added complete bundle as recommended package
- Updated from 5 skills to 7 skills
- Added installation instructions for complete bundle
- Added verification examples for Code skills
- Noted that Code skills are only in complete bundle
- Marked old bundle name as legacy

## Installation Methods

**Method 1: Direct plugin installation**
```bash
/plugin install czlonkowski/n8n-skills
```

**Method 2: From marketplace**
```bash
/plugin marketplace add czlonkowski/n8n-skills
/plugin install
```

**Method 3: Local zip**
```bash
/plugin install /path/to/n8n-mcp-skills-v1.0.0.zip
```

## Package Statistics

- **Total size**: 168 KB (compressed)
- **Files**: 50 files
- **Skills**: 7 complete skills
- **Lines of code**: ~20,000+ lines across all skills
- **Evaluations**: 23 test scenarios

## Version

Version: 1.0.0
Release Date: October 20, 2025

🤖 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 14:37:51 +02:00
czlonkowski
15285fb390 fix: Change repository field from object to string in plugin.json 
Claude Code expects repository field to be a string, not an object.

Error: repository: Expected string, received object

Changed from:
"repository": { "type": "git", "url": "..." }

To:
"repository": "https://github.com/czlonkowski/n8n-skills"

This follows Claude Code's plugin.json schema where repository is a simple
string URL rather than npm's package.json format.

Distribution package regenerated with corrected plugin.json.

🤖 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:28:05 +02:00
czlonkowski
055c35079b fix: Correct marketplace.json source path format 
Change source from "." to "./" to comply with Claude Code marketplace
schema validation requirement.

Error: plugins.0.source: Invalid input: must start with "./"

🤖 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:20:07 +02:00
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