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
10 Commits 1 Branch 0 Tags
bf9e1b46a320c8697d112d801ca9a14b1fa4f46b
Commit Graph

3 Commits

Author SHA1 Message Date
czlonkowski
bf9e1b46a3 docs: Document workflow activation limitation across skills 
Add critical limitation notice that workflow activation is not supported
via API or MCP and requires manual activation in n8n UI.

Changes:
- WORKFLOW_GUIDE.md: Added prominent warning in lifecycle section with
  deployment steps for users
- SKILL.md (workflow-patterns): Added inline warning in deployment checklist
- scheduled_tasks.md: Added activation reminder in deployment checklist
- VALIDATION_GUIDE.md: Added to best practices "Do" section

Context: During practical workflow deployment, discovered that the
n8n_update_partial_workflow operation with active:true setting does not
activate workflows. This is a critical limitation that users must understand
to successfully deploy workflows built via MCP.

Locations updated (4 files):
1. skills/n8n-mcp-tools-expert/WORKFLOW_GUIDE.md (primary)
2. skills/n8n-workflow-patterns/SKILL.md (deployment phase)
3. skills/n8n-workflow-patterns/scheduled_tasks.md (deployment checklist)
4. skills/n8n-mcp-tools-expert/VALIDATION_GUIDE.md (best practices)

🤖 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:35:39 +02:00
czlonkowski
33e83c29dc refactor: Remove research context from skill content 
Cleaned up all skills to remove research/telemetry context that was used
during design but is not needed at runtime when AI agents use the skills.

## Changes Made

### Pattern 1: Research Framing Removed
- "From analysis of X workflows/events" → Removed
- "From telemetry analysis:" → Replaced with operational context
- "Based on X real workflows" → Simplified to general statements

### Pattern 2: Popularity Metrics Removed
- "**Popularity**: Second most common (892 templates)" → Removed entirely
- "813 searches", "456 templates", etc. → Removed

### Pattern 3: Frequency Percentages Converted
- "**Frequency**: 45% of errors" → "Most common error"
- "**Frequency**: 28%" → "Second most common"
- "**Frequency**: 12%" → "Common error"
- Percentages in tables → Priority levels (Highest/High/Medium/Low)

### Pattern 4: Operational Guidance Kept
- ✅ Success rates (91.7%) - helps tool selection
- ✅ Average times (18s, 56s) - sets expectations
- ✅ Relative priority (most common, typical) - guides decisions
- ✅ Iteration counts (2-3 cycles) - manages expectations

## Files Modified (19 files across 4 skills)

**Skill #2: MCP Tools Expert (5 files)**
- Removed telemetry occurrence counts
- Kept success rates and average times

**Skill #3: Workflow Patterns (7 files)**
- Removed all popularity metrics from pattern files
- Removed "From analysis of 31,917 workflows"
- Removed template counts

**Skill #4: Validation Expert (4 files)**
- Converted frequency % to priority levels
- Removed "From analysis of 19,113 errors"
- Removed telemetry loop counts (kept iteration guidance)

**Skill #5: Node Configuration (3 files)**
- Removed workflow update counts
- Removed essentials call counts
- Kept success rates and timing guidance

## Result

Skills now provide clean, focused runtime guidance without research
justification. Content is more actionable for AI agents using the skills.

All technical guidance, examples, patterns, and operational metrics preserved.
Only removed: research methodology, data source attribution, and statistical
justification for design decisions.

🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
 2025-10-20 11:45:04 +02:00
czlonkowski
651467dee6 feat: Complete Skill #3 - n8n Workflow Patterns 
Implements comprehensive workflow pattern guidance from 31,917 real workflows.
Addresses the most common use case (813 webhook searches).

Files created:
- 5 evaluations testing pattern selection and implementation
- SKILL.md (486 lines) - Pattern overview, selection guide, workflow checklist
- webhook_processing.md (554 lines) - Webhook patterns, $json.body gotcha, auth
- http_api_integration.md (763 lines) - REST APIs, pagination, rate limiting
- database_operations.md (854 lines) - DB ops, batch processing, SQL injection prevention
- ai_agent_workflow.md (918 lines) - AI agents, 8 connection types, tool configuration
- scheduled_tasks.md (845 lines) - Cron schedules, timezone handling, monitoring
- README.md - Skill metadata with pattern statistics

Key features:
- 5 core patterns: Webhook (35%), HTTP API (892 templates), Database (456), AI (234), Scheduled (28%)
- Workflow creation checklist (planning → implementation → validation → deployment)
- Pattern selection guide with statistics
- Common gotchas documented (webhook $json.body, SQL injection, timezone, etc.)
- Error handling strategies for each pattern
- Performance optimization techniques
- Security best practices
- Testing approaches
- Real template examples

Critical insights:
- Webhook data under $json.body (not $json) - #1 gotcha
- Always use parameterized queries (SQL injection prevention)
- ANY node can be an AI tool (connect to ai_tool port)
- Set workflow timezone explicitly (DST handling)
- Authentication via credentials (never hardcode)

Pattern statistics:
- Trigger distribution: Webhook 35%, Schedule 28%, Manual 22%, Service 15%
- Transformation: Set 68%, Code 42%, IF 38%, Switch 18%
- Output: HTTP 45%, Slack 32%, Database 28%, Email 24%
- Complexity: Simple 42%, Medium 38%, Complex 20%

Total: ~4,420 lines across 12 files

Based on analysis of 31,917 real workflows and usage patterns.

🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
 2025-10-20 10:38:38 +02:00