czlonkowski
74e662e1f5
feat: Add n8n-code-javascript skill (Skill #6 )
...
Complete expert guidance for writing JavaScript in n8n Code nodes.
Files added (6 skill files + 5 evaluations):
- SKILL.md (699 lines) - Quick start, mode selection, data access overview
- DATA_ACCESS.md (782 lines) - Complete data access patterns
- COMMON_PATTERNS.md (1,110 lines) - 10 production-tested patterns
- ERROR_PATTERNS.md (763 lines) - Top 5 errors covering 62%+ of failures
- BUILTIN_FUNCTIONS.md (764 lines) - Complete built-in function reference
- README.md (350 lines) - Skill metadata and overview
Total: 4,468 lines across 6 files + 5 evaluation scenarios
Key features:
- Data access patterns: $input.all(), $input.first(), $input.item
- Critical gotcha highlighted: Webhook data under .body
- Return format emphasized: [{json: {...}}]
- Top 5 error patterns with solutions (38%, 8%, 5%, 6% of failures)
- 10 production-tested patterns (multi-source aggregation, regex filtering, etc.)
- Complete built-in function reference ($helpers.httpRequest, DateTime, $jmespath)
- Mode selection guide (All Items vs Each Item)
Evaluations (5):
- eval-001: Webhook body gotcha (most common mistake)
- eval-002: Return format error (missing array wrapper)
- eval-003: HTTP requests with $helpers.httpRequest()
- eval-004: Aggregation pattern with reduce()
- eval-005: Expression syntax confusion (using {{}} in code)
Documentation updates:
- README.md: Updated from 5 to 7 skills
- plugin.json: Added code/javascript/python keywords
- marketplace.json: Updated description to reflect 7 skills
Ready for: Production use
🤖 Generated with Claude Code
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 14:20:53 +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
dff62f0c52
feat: Complete Phase 1 - Foundation and Documentation
...
## Phase 1 Achievements
✅ Repository Structure:
- Created complete directory structure (skills/, evaluations/)
- Updated .gitignore (removed docs/, keep .mcp.json)
✅ MCP Testing:
- Verified n8n API availability (https://n8n-test.n8n-mcp.com )
- Tested MCP tools comprehensively
- Created MCP_TESTING_LOG.md with real tool responses
✅ Documentation:
- README.md: Comprehensive project overview with data-driven insights
- INSTALLATION.md: Complete installation guide for all platforms
- USAGE.md: Detailed usage examples and cross-skill composition
- DEVELOPMENT.md: Development guidelines and contribution process
## Key Insights from MCP Testing
- 537 nodes available (437 base + 100 langchain)
- 2,653 templates with metadata
- nodeType format differences documented
- Webhook data structure clarified ($json.body)
- Auto-sanitization behavior documented
- All n8n_* tools require API; all others don't
## Next: Phase 2 - Skill #1 (n8n Expression Syntax)
🤖 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 10:14:34 +02:00
