Commit Graph

6 Commits

Author SHA1 Message Date
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