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
22 Commits 1 Branch 0 Tags
main
Commit Graph

5 Commits

Author SHA1 Message Date
Romuald Członkowski
d9c2872029 feat: Update skills for n8n-mcp unified tool API (v1.1.0) 
BREAKING: Updated all skills to reflect n8n-mcp tool consolidation:

## Tool API Changes
- get_node_essentials → get_node({detail: "standard"})
- get_node_info → get_node({detail: "full"})
- get_node_documentation → get_node({mode: "docs"})
- search_node_properties → get_node({mode: "search_properties"})
- validate_node_minimal → validate_node({mode: "minimal"})
- validate_node_operation → validate_node({mode: "full"})
- get_property_dependencies → REMOVED (use get_node modes)

## New Features Documented
- Workflow activation via API (activateWorkflow/deactivateWorkflow operations)
- n8n_deploy_template - deploy templates directly to n8n
- n8n_workflow_versions - version history and rollback
- n8n_test_workflow - trigger execution
- n8n_executions - manage executions
- Smart parameters (branch, case) for IF/Switch connections
- Intent parameter for better AI responses

## Documentation Updates
- Added YouTube video introduction with thumbnail
- Added GitHub stars badge (1.2k milestone)
- Added build.sh script for dist packaging
- Fixed "5 skills" → "7 skills" inconsistency in README

## Files Updated
- n8n-mcp-tools-expert: Complete rewrite of SKILL.md, SEARCH_GUIDE.md,
  VALIDATION_GUIDE.md, WORKFLOW_GUIDE.md
- n8n-node-configuration: Updated SKILL.md, DEPENDENCIES.md
- n8n-validation-expert: Updated SKILL.md, ERROR_CATALOG.md, FALSE_POSITIVES.md
- n8n-workflow-patterns: Updated SKILL.md, README.md
- README.md, CLAUDE.md: Modernized documentation

Conceived by Romuald Członkowski - www.aiadvisors.pl/en

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-08 15:37:57 +01:00
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
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
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