2 Commits

Author SHA1 Message Date
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
97e1d21793 feat: Complete Skill #5 - n8n Node Configuration (ALL 5 SKILLS COMPLETE!)
Implements operation-aware node configuration with progressive discovery.
Completes the final skill in the 5-skill n8n meta-skill collection.

Files created:
- 4 evaluations testing dependencies, operations, conditional fields, tool selection
- SKILL.md (692 lines) - Configuration workflow, progressive discovery, patterns
- DEPENDENCIES.md (671 lines) - displayOptions mechanism, dependency patterns
- OPERATION_PATTERNS.md (783 lines) - 20+ nodes with common configurations
- README.md (380 lines) - Skill metadata with usage statistics

Key features:
- Operation-aware configuration (resource + operation = requirements)
- Property dependencies (displayOptions show/hide rules)
- Progressive discovery (essentials → dependencies → info)
- Configuration workflow (identify → discover → configure → validate → iterate)
- 4 common node patterns (resource/operation, HTTP, database, conditional)
- Tool selection guide (get_node_essentials 91.7% success rate)
- Dependency troubleshooting (field visibility, conditional requirements)
- 20+ node configuration examples with gotchas

Progressive discovery strategy:
1. get_node_essentials (91.7% success, 18s avg from search)
2. get_property_dependencies (when dependencies unclear)
3. get_node_info (only when necessary, full schema)

Property dependency patterns:
- Boolean toggle (sendBody → body)
- Resource/operation cascade (different ops → different fields)
- Type-specific config (string vs number conditions)
- Method-specific fields (GET vs POST)

Common node patterns covered:
- HTTP Request (GET/POST/PUT/DELETE with auth, query, body)
- Webhook (basic/auth/response, $json.body gotcha)
- Slack (post/update/create channel)
- Gmail (send/get with filters)
- Postgres (query/insert/update with parameters)
- Set (fixed values/mapping with types)
- Code (per-item/all-items, no expressions!)
- IF (string/number/boolean, unary vs binary)
- Switch (rules with fallback)
- OpenAI (chat completion with system prompt)
- Schedule (daily/interval/cron with timezone)

Key insights:
- 91.7% configurations succeed with essentials only
- Average 56 seconds between configuration edits (iterative)
- 9,835 essentials calls vs fewer full schema calls
- 18 seconds average from node search to essentials
- Different operations = different requirements (always check!)

Top 5 gotchas documented:
1. Webhook data under $json.body (not $json)
2. POST needs sendBody: true
3. Slack channel format (#name for public)
4. SQL parameterized queries (prevent injection)
5. Schedule timezone must be explicit (DST handling)

displayOptions mechanism:
- show: Field appears when conditions match
- hide: Field disappears when conditions match
- AND logic: All conditions must match
- OR logic: Any value matches
- Nested: Parent value controls child structure

Total: ~2,526 lines across 8 files

Based on analysis of 38,287 workflow updates and 9,835 essentials calls.

🎉 ALL 5 CORE SKILLS NOW COMPLETE! 🎉

Skills completed:
1.  n8n Expression Syntax (1,275 lines)
2.  n8n MCP Tools Expert (1,325 lines)
3.  n8n Workflow Patterns (3,932 lines)
4.  n8n Validation Expert (2,553 lines)
5.  n8n Node Configuration (2,526 lines)

Total: ~11,611 lines across 36 files + 22 evaluations
All skills data-driven from 447,557 real MCP tool usage events.

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