CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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. Also use when optimizing a slow workflow or speeding up large-item-count processing (node count, batchSize, all-items vs per-item).

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

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

The body delivers genuinely expert, hard-to-guess n8n guidance with an exemplary validation-gated lifecycle and checklist, and most sections are token-efficient and actionable. Its weaknesses are repetition and filler (statistics and template-anecdote sections), and a progressive-disclosure failure: five referenced pattern files are absent from the bundle while equivalent detail for the sixth pattern is inlined.

Suggestions

Ship the five referenced pattern files (webhook_processing.md, http_api_integration.md, database_operations.md, ai_agent_workflow.md, scheduled_tasks.md) or remove the links — every pattern-file link in the body currently dead-ends because the files are absent from the bundle.

Cut or compress the low-yield sections: Pattern Statistics, Real Template Examples, the Summary/Next Steps/Related Skills triple, and the duplicate pattern listings (the '6 Core Patterns' and 'Pattern Selection Guide' lists say nearly the same thing twice).

Move the inline Batch Processing, Performance, and Integration-Specific Gotchas detail into the pattern files so SKILL.md reads as the overview it claims to be, keeping only the pattern-selection and lifecycle guidance at the top level.

DimensionReasoningScore

Conciseness

The dense n8n-specific sections (SplitInBatches semantics, lifecycle gates, Google Sheets/Drive gotchas, performance rules) earn their tokens and teach things Claude would not know. But the ~550-line body carries real padding: the pattern list is repeated three times ("The 6 Core Patterns", "Pattern Selection Guide", "Detailed Pattern Files"), the "Pattern Statistics" percentages and "Real Template Examples" sections add near-zero actionable content ("AI Agents: Growing in usage — Most common: Chatbots"), and the Do/Don't list includes trivia like "iterate! avg 56s between edits". This matches the 3 anchor (mostly efficient, some unnecessary material) rather than 2, since nothing explains concepts Claude already knows and the core guidance is tight.

3 / 5

Actionability

Guidance is concrete and executable: exact node-output semantics ("main[0] = done", "main[1] = each batch"), copy-paste code for dry-run verification and Math.abs threshold checks, exact expressions (`{{ $json.price.toNumber() }}`), concrete URLs (`https://drive.google.com/uc?id={fileId}&export=download`), ASCII wiring diagrams, and named tool calls (validate_workflow, n8n_test_workflow). It stops short of the 5 anchor because the Quick Start "examples" are node-name lists without the key configuration (auth, operation, expressions), and the full workflow-JSON pattern is deferred to pattern files that are not present, leaving a gap between promise and executable detail.

4 / 5

Workflow Clarity

The "validate, verify, test before activating" section is an explicit four-gate sequence with the rule "validation passing is necessary, not sufficient", per-gate tool invocations, feedback loops ("Fix every error and re-validate"), and a safety checkpoint ("Real side effects fire during a test... confirm with the user before running"). It is reinforced by the four-phase creation checklist with validation items in each phase. This squarely matches the 5 anchor (clear sequence, explicit validation, feedback loops, checklist) and clearly exceeds 4's "most checkpoints".

5 / 5

Progressive Disclosure

Section headers are clear and pattern references are well-labeled with one-line descriptions, but the disclosure contract is broken: the body links to five pattern files (webhook_processing.md, http_api_integration.md, database_operations.md, ai_agent_workflow.md, scheduled_tasks.md) that do not exist in the bundle, so navigation dead-ends. Simultaneously, content that clearly belongs in those detail files — the full Batch Processing pattern, Performance, and Integration-Specific Gotchas sections — is inlined, and the batch pattern is even flagged "(below)" while its siblings point outward. This sits between anchors 2 and 3: better organized than "minimal structure / buried references", but the missing files plus inline bulk keep it from 4.

3 / 5

Total

15

/

20

Passed

Description

91%Weight 40%Scale 1-5

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

A strong description: it clearly states what the skill provides, gives explicit and exhaustive "use when" triggers including a catch-all for users who omit the word "patterns", and stays in third person. The only weaknesses are a slightly abstract headline verb set and one unscoped automation clause that could over-trigger.

DimensionReasoningScore

Specificity

The description lists several concrete action contexts — "building new workflows, designing workflow structure, choosing workflow patterns, planning workflow architecture" and "optimizing a slow workflow or speeding up large-item-count processing (node count, batchSize, all-items vs per-item)" — and enumerates six covered architectures (webhook, API, database, AI, batch, scheduled). It falls short of the 5 anchor because the headline "what" is a resource description ("Proven workflow architectural patterns") rather than a list of concrete operations, and verbs like "designing" and "choosing" stay somewhat abstract; it is clearly above 3's "1-2 concrete actions" coverage.

4 / 5

Completeness

Both halves are explicit: the "what" ("Proven workflow architectural patterns from real n8n workflows... Covers webhook, API, database, AI, batch processing, and scheduled automation architectures") and the "when" ("Use when building new workflows... Always consult this skill when the user asks to create, build, or design an n8n workflow, automate a process, or connect services"), with concrete trigger phrases throughout — matching the 5 anchor. Voice is third person throughout, so no voice penalty applies.

5 / 5

Trigger Term Quality

Comprehensive natural-phrase coverage: "webhook processing", "HTTP API integration", "database operations", "AI agent workflows", "batch processing", "scheduled tasks", "automate a process", "connect services", "optimize a slow workflow", plus the brand term "n8n" and the explicit catch "even if they don't explicitly mention 'patterns'". It matches the 5 anchor's synonym-and-variation coverage; no common phrasing is missing.

5 / 5

Distinctiveness Conflict Risk

The n8n niche and its pattern vocabulary are distinct, and the description names the platform explicitly, giving minimal conflict with unrelated skills. However, the clause "Always consult this skill when the user asks to... automate a process, or connect services" is unscoped by n8n and would fire on generic automation/integration requests, so it sits at 4 ("mostly distinct; minor overlap risk") rather than 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

relative_links

Relative link issues: 10 missing

Warning

Total

14

/

16

Passed

Repository

czlonkowski/n8n-skills

Path

skills/n8n-workflow-patterns/SKILL.md

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.