{"skill":{"slug":"n8n","displayName":"n8n","summary":"Manage n8n workflows and automations via API. Use when working with n8n workflows, executions, or automation tasks - listing workflows, activating/deactivating, checking execution status, manually triggering workflows, or debugging automation issues.","tags":{"latest":"2.0.0"},"stats":{"comments":0,"downloads":17441,"installsAllTime":191,"installsCurrent":180,"stars":54,"versions":4},"createdAt":1768419094732,"updatedAt":1777611170791},"latestVersion":{"version":"2.0.0","createdAt":1770748031005,"changelog":"# Changelog - n8n Enhanced Workflow Management Skill\n\n## Version 2.0.0 - 10 Feb  2026\n\n### 🎉 Major Enhancement Release\n\nComplete redesign of the n8n skill with comprehensive workflow lifecycle management capabilities.\n\n### ✨ New Features\n\n#### Testing & Validation\n- **Structure Validation:** `n8n_tester.py` validates workflow integrity\n  - Node and connection validation\n  - Credential checking\n  - Configuration verification\n  - Flow analysis\n- **Dry-Run Testing:** Test workflows with sample data before activation\n- **Test Suites:** Run multiple test cases against workflows\n- **Validation Reports:** Human-readable test reports with errors and warnings\n\n#### Execution Monitoring\n- **Enhanced Execution Tracking:** Real-time execution monitoring\n- **Detailed Statistics:** Success/failure rates, execution patterns\n- **Error Analysis:** Identify and categorize failure patterns\n- **Retry Logic:** Built-in retry support for failed executions\n\n#### Performance Optimization\n- **Performance Analysis:** `n8n_optimizer.py` provides comprehensive metrics\n  - Execution metrics (success rate, failure patterns)\n  - Node analysis (complexity, expensive operations)\n  - Connection analysis (parallel paths, bottlenecks)\n  - Performance scoring (0-100)\n- **Bottleneck Detection:** Identify workflow performance issues\n  - Sequential expensive operations\n  - High failure rates\n  - Missing error handling\n- **Optimization Suggestions:** Actionable recommendations\n  - Parallel execution opportunities\n  - Caching strategies\n  - Batch processing\n  - Error handling improvements\n  - Complexity reduction\n- **Optimization Reports:** Human-readable performance reports\n\n### 📝 API Extensions\n\n#### n8n_api.py Enhancements\n- `validate_workflow()` - Validate workflow structure\n- `dry_run_workflow()` - Test workflow with mock data\n- `get_workflow_statistics()` - Get execution statistics\n- `analyze_workflow_performance()` - Performance analysis\n- CLI support for `create`, `validate`, and `stats` commands\n\n#### New Modules\n- **n8n_tester.py** - Testing and validation\n  - Structure validation\n  - Dry-run execution\n  - Test suite runner\n  - Report generation\n- **n8n_optimizer.py** - Performance optimization\n  - Performance analysis\n  - Bottleneck detection\n  - Optimization suggestions\n  - Report generation\n\n### 📚 Documentation\n\n#### New Documentation\n- **README.md** - Quick start guide with examples\n- **SKILL.md** - Comprehensive documentation (16KB)\n  - All CLI commands\n  - Python API examples\n  - Common workflows\n  - Best practices\n  - Troubleshooting guide\n- **templates/README.md** - Template documentation\n  - Template descriptions\n  - Configuration guides\n  - Test data examples\n- **CHANGELOG.md** - This file\n\n#### Updated Documentation\n- Enhanced quick reference\n- Added validation examples\n- Performance optimization guides\n- Template usage examples\n\n### 🗂️ File Structure\n\n```\n~/clawd/skills/n8n/\n├── README.md                   # Quick start guide\n├── SKILL.md                    # Comprehensive documentation\n├── CHANGELOG.md                # This file\n├── scripts/\n│   ├── n8n_api.py             # Core API client (extended)\n│   ├── n8n_tester.py          # NEW: Testing & validation\n│   └── n8n_optimizer.py       # NEW: Performance optimization\n└── references/\n    └── api.md\n```\n\n### 🔧 Technical Improvements\n\n- **Modular Design:** Separated concerns into specialized modules\n- **Error Handling:** Comprehensive error checking and reporting\n- **Import Flexibility:** Support for both direct and module imports\n- **Validation Logic:** Standalone validation without API dependency\n- **Performance Metrics:** Multi-dimensional workflow analysis\n- **Extensible Templates:** Easy to add new workflow templates\n\n### 📊 Metrics & Analysis\n\nNew performance metrics tracked:\n- Execution success/failure rates\n- Node complexity scores (0-100)\n- Performance scores (0-100)\n- Health status (excellent/good/fair/poor)\n- Bottleneck severity levels\n- Optimization priorities (high/medium/low)\n\n### 🎯 Use Cases\n\nThe enhanced skill now supports:\n1. **Rapid Prototyping:** Deploy templates and test within minutes\n2. **Quality Assurance:** Validate and test before production deployment\n3. **Performance Tuning:** Identify and resolve bottlenecks\n4. **Continuous Monitoring:** Track workflow health over time\n5. **Best Practices:** Built-in optimization recommendations\n\n### 🔄 Migration from v1.0\n\nNo breaking changes. All v1.0 functionality preserved and enhanced:\n- `list-workflows` - Still works\n- `get-workflow` - Still works\n- `activate` / `deactivate` - Still works\n- `list-executions` / `get-execution` - Still works\n- `execute` - Still works\n\nNew commands added:\n- `create` - Create workflows from templates or files\n- `validate` - Validate workflow structure\n- `stats` - Get execution statistics\n\n### 🐛 Bug Fixes\n\n- Fixed import issues in testing module\n- Added standalone validation for file-based workflows\n- Improved error messages for missing credentials\n- Enhanced connection validation logic\n\n### ⚡ Performance\n\n- Validation runs without API calls for file-based workflows\n- Efficient execution monitoring with configurable polling\n- Optimized statistics calculation for large execution histories\n\n### 🔐 Security\n\n- No credentials stored in templates (placeholders only)\n- Environment variable-based authentication\n- Validation runs safely without modifying workflows\n\n### 📦 Dependencies\n\nNo new dependencies\n- `requests` (existing)\n- `json`, `sys`, `argparse`, `pathlib`, `typing` (standard library)\n\n### 🚀 Future Roadmap\n\nPlanned for future releases:\n- Additional workflow templates (10+ total)\n- Workflow versioning and rollback\n- A/B testing framework\n- Cost tracking and optimization\n- Workflow dependencies and orchestration\n- Visual workflow builder web UI\n- AI-powered workflow optimization\n- Integration testing framework\n\n### 👥 Contributors\n\n- Enhanced n8n skill for Clawdbot/Thomas\n- Based on requirements for SaaS automation workflows\n\n### 📄 License\n\nPart of the Clawdbot skills library.\n\n---\n\n## Version 1.0.0 - January 2026\n\n### Initial Release\n\nBasic n8n API integration:\n- List workflows\n- Get workflow details\n- Activate/deactivate workflows\n- List and get executions\n- Manual workflow execution\n- Python API client\n- Basic CLI interface","license":null},"metadata":{"os":null,"systems":null},"owner":{"handle":"thomasansems","userId":"s1759pf0b5r8mvs15r10wd6ak5846vjk","displayName":"thomasansems","image":"https://avatars.githubusercontent.com/u/8612092?v=4"},"moderation":{"isSuspicious":true,"isMalwareBlocked":false,"verdict":"suspicious","reasonCodes":["suspicious.llm_suspicious"],"summary":"Detected: suspicious.llm_suspicious","engineVersion":"v2.4.22","updatedAt":1777611170791}}