CtrlK
BlogDocsLog inGet started
Tessl Logo

n8n-workflow-patterns

Proven workflow architectural patterns from real n8n workflows. Use when building new workflows, designing workflow structure, choosing workflow patterns, planning workflow architecture, or asking about webhook processing, HTTP API integration, database operations, AI agent workflows, batch processing, or scheduled tasks. Always consult this skill when the user asks to create, build, or design an n8n workflow, automate a process, or connect services — even if they don't explicitly mention 'patterns'. Covers webhook, API, database, AI, batch processing, and scheduled automation architectures.

55

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Critical

Do not install without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/n8n-workflow-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description with excellent trigger term coverage and completeness. The 'Use when' and 'Always consult' clauses provide thorough guidance for skill selection. The main weakness is that the specificity of capabilities leans more toward listing categories of patterns rather than concrete actions the skill enables, though this is somewhat inherent to the nature of a reference/patterns skill.

DimensionReasoningScore

Specificity

The description names the domain (n8n workflows) and lists several pattern categories (webhook processing, HTTP API integration, database operations, AI agent workflows, batch processing, scheduled tasks), but these are more like categories than concrete actions. It doesn't describe specific actions like 'generates workflow JSON' or 'configures webhook nodes' — it's more about providing architectural patterns.

2 / 3

Completeness

Clearly answers both 'what' (proven workflow architectural patterns for n8n covering webhook, API, database, AI, batch, and scheduled architectures) and 'when' (explicit 'Use when' clause plus an 'Always consult this skill when' clause with detailed trigger scenarios). The when guidance is particularly thorough.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'building new workflows', 'workflow structure', 'workflow patterns', 'webhook processing', 'HTTP API integration', 'database operations', 'AI agent workflows', 'batch processing', 'scheduled tasks', 'create', 'build', 'design', 'automate a process', 'connect services', and 'n8n workflow'. These are highly natural phrases a user would use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific focus on n8n workflow architectural patterns. The combination of 'n8n' as a platform identifier plus 'architectural patterns' as the skill type creates a clear niche that is unlikely to conflict with other skills, even other n8n-related skills that might focus on node configuration or debugging.

3 / 3

Total

11

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides broad coverage of n8n workflow patterns with some genuinely useful gotchas (Google Sheets formulas, SplitInBatches output mapping, cross-iteration data accumulation) but is severely bloated with redundant sections, fabricated statistics, and content Claude already knows. The actionability is moderate — real code snippets exist for specific gotchas but the core patterns lack executable workflow definitions. The file would benefit enormously from aggressive trimming and moving detailed content into the referenced sub-files.

Suggestions

Cut the file by at least 50%: remove 'Pattern Statistics' (fabricated numbers add no value), 'Common Workflow Components' (Claude knows what triggers and data sources are), 'Summary/Next Steps' (repeats earlier content), and 'Real Template Examples' (too vague to be useful).

Move the 'Batch Processing Pattern', 'Integration-Specific Gotchas', and 'Common Gotchas' sections into their own referenced files, keeping only 1-2 line summaries in the main SKILL.md.

Replace the ASCII pseudocode 'Quick Start Examples' with actual executable n8n workflow JSON snippets or concrete node configuration objects that can be used with the MCP tools.

Add explicit error recovery feedback loops to the workflow creation checklist (e.g., 'If validate_workflow fails → review errors → fix → re-validate before proceeding').

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Contains significant padding: pattern statistics with made-up percentages, redundant 'Summary' and 'Next Steps' sections that repeat earlier content, 'Real Template Examples' section that adds little value, explanations of basic concepts (what triggers are, what data sources are), and the 'Common Workflow Components' section describes things Claude already knows. The 'Best Practices' and 'Integration with Other Skills' sections are largely filler. Much of this could be cut by 60%+ without losing actionable information.

1 / 3

Actionability

Provides some concrete guidance like the SplitInBatches output mapping, webhook data structure gotcha, Google Sheets gotchas with specific code fixes, and the dry-run verification pattern. However, the 'Quick Start Examples' are pseudocode node lists rather than executable workflow JSON or actual n8n configurations. Most patterns are described abstractly (ASCII flow diagrams) rather than with concrete, copy-paste-ready workflow definitions or node configurations.

2 / 3

Workflow Clarity

The workflow creation checklist provides a clear multi-step sequence with a validation phase, which is good. The batch processing section has clear sequencing with explicit wiring instructions. However, the main 6 patterns are described only at a high level without validation checkpoints within each pattern. The checklist mentions 'validate each node' and 'validate complete workflow' but doesn't specify what to do when validation fails (no feedback loop for error recovery in the checklist itself).

2 / 3

Progressive Disclosure

References to detailed pattern files (webhook_processing.md, http_api_integration.md, etc.) are well-signaled and one level deep, which is good. However, the SKILL.md itself is a monolithic wall of text that inlines too much content — the batch processing pattern, common gotchas, integration gotchas, pattern statistics, and best practices could all be in separate files. The main file should be a concise overview pointing to these details, not containing all of them inline.

2 / 3

Total

7

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (513 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

Repository
czlonkowski/n8n-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.